Help:Redirects
For information oriented towards site admins and developers, see Manual:Redirects instead
Note: When you edit this page, you agree to release your contribution under the CC0. See Public Domain Help Pages for more info. |
Redirects are used to forward users from one page name to another. They can be useful if a particular article is referred to by multiple names, or has alternative punctuation, capitalization or spellings.
Types of redirects
Two types of redirections exist:
- Hard redirection: Readers navigating to the redirect page are taken directly to the target page (usually other pages of the same wiki). When a page is a redirect, you can no longer get to that page by using its name or by any link using that name. Only hard redirection is described in this current article.
- Soft redirection: Readers are left on the redirect page but given the option of clicking the link to the target page. Usually this is achieved via a template; see corresponding article on Meta.
Appearance
Following a redirect
When a hard redirect is followed, the target page is immediately displayed, with a small notice below the page title to indicate you arrived here indirectly.
Help:RedirectsFrom mediawiki.org(Redirected from Help:Redirect)
You can use the link in this notice to view the redirect page.
This link adds the &redirect=no
URL parameter.
Viewing a redirect
When a redirect page is displayed, the small notice below the page title indicates this, and the link after the arrow icon displays the target of the redirect.
Help:RedirectFrom mediawiki.orgRedirect page
Once you view it, you can do all the things with the redirect page that any wiki page allows. You can go to the associated discussion page to discuss the redirect. You can view the history of the page, including a record of the redirect. You can edit the page if the redirect is wrong, and you can revert to an older version to remove the redirect.
Creating a redirect
When a page is moved, a redirect from the old to the new page name is automatically created.
Users with the "suppressredirect
" right may move a page without creating a redirect.
By default this right is assigned to sysops and bots.
You may start a new page with the name you want to direct from (see Help:Starting a new page ). You can also use an existing page that you are making inactive as a page by going to that page and using the "edit" tab at the top. In either case, you will be inserting the following code at the very first text position of the Edit window for the page:
#REDIRECT [[pagename]]
where pagename is the name of the destination page.
The word "redirect" is not case-sensitive, but there must be no space before the "#
" symbol.
If any text is present before this line, it will disable the redirect.
However, text or other content may appear after this line.
This is often used to add redirects to categories.
Redirections can be simple page names or specified using a namespace. They can be suffixed with a section name if you have the corresponding anchor defined on the target page.
Examples of valid operational redirections:
#REDIRECT[[Help:Magic_words#Page_names]]
#redirect [[Help:Magic_words#URL_encoded_page_names]]
#Redirect [[Manual:$wgConf]]
#REDIRECT [[MediaWiki/fr]]
You should 'preview' (using the button below the Edit window, or use Alt+P) to check that you have entered the correct destination page name.
When the redirect is valid, it will appear in preview as shown in the "Viewing a redirect" section above.
When the redirect is not valid, it will appear in preview like a numbered list item:
- REDIRECT pagename
If the pagename as you typed it is not a valid page, it will show in red. If there is no valid destination page, you should not create the redirect.
Limitations
A redirect target cannot depend on a variable, template, or parser function. If that is the case, the browser will not be automatically redirected on visiting the page.
Example of redirection not allowed (not operational):
#REDIRECT [[{{ll|Help:Magic_words#Page_names}}]]
although{{ll|Help:Magic_words#Page_names}}
is operational.
JavaScript page redirect
In order to avoid JavaScript functionality from breaking, all JavaScript pages have a different redirect syntax from regular pages. This syntax allows for proper execution of the page by the browser's JavaScript engine, as well as being recognised by MediaWiki as a redirect. To create a JavaScript page redirect, the format that must be used is as follows:
/* #REDIRECT */mw.loader.load( "{{fullurl:Target.js|action=raw&ctype=text/javascript}}" );
Where Target.js
is the target page name.
Deleting a redirect
There's generally no need to delete redirects. They do not occupy a significant amount of database space. If a page name is vaguely meaningful, there's no harm, and some benefit, in having it as a redirect to the more relevant or current page.
If want to move a page over a redirect that has only one edit in its history and targeted to the old page name, there is no need to delete the redirect: it is overwritten. If the redirect has more than one history entry, or the redirect target is somewhere else, then it can only be deleted-and-moved by an administrator.
If you do need to delete a redirect, e.g. if the page name is offensive, or you wish to discourage people from referring to a concept by that name, then you simply go to the redirect page as mentioned above, and follow the procedures at Help:Deletion and undeletion .
Problematical redirects
Double redirects
A double redirect is a page redirecting to a page which is itself a redirect, and it will not work. Instead, people will be presented with a view of the next redirect page. This is a deliberate restriction, partly to prevent infinite loops, and partly to keep things simple.
However, you could look out for double redirects and eliminate them by changing them to be 1-step redirects instead. You are most likely to need to do this after a significant page move. Use the "what links here" toolbox link to find double redirects to a particular page, or use Special:DoubleRedirects to find them throughout the whole wiki.
There is an option, $wgFixDoubleRedirects , to automatically fix double redirects with a job queue. However, it tends to aggravate page move vandalism, so it is disabled by default. The __STATICREDIRECT__ magic word can be used to skip the double-redirect fix on a particular page.
Broken redirects
If the target page does not exist, the redirect is broken: redirection will not occur. You may find all broken redirects at Special:BrokenRedirects.
Transcluding a redirect
When a page called for inclusion is a redirect page, the redirect target is included instead, with the same parameters, without any redirect message. A double redirect does not work.
This allows to create several names for the same template.
Links to redirect
An internal link to a redirect page has CSS class mw-redirect
.
This can be useful to make them stand out, for clean-up work involving bypassing redirects.
See also
- Manual:Redirects
- Template:Soft redirect — for soft redirections.
- Manual:Redirect table
- OutputPage::redirect() — for redirecting to arbitrary URLs from within PHP.
- Category:Redirect extensions
- Wikipedia guide on redirects