10.2 Redirects

What is a redirect?

A redirect is a technique to automatically forward users from one page to another. If you redirect a page that has content, the user will not see the content of the redirected page, but only the content of the target page.

When to use a redirect

Pages are usually redirected in the following cases:

  • abbreviations
  • synonyms
  • duplicate content
  • spelling variants
  • plural/singular
  • renaming/moving a page

How to redirect a page

Visual editing mode

  1. Click the options menu in the visual editor toolbar and select the Page settings link:
    Page settings menu item
    Page settings menu item
  2. Activate the checkbox Redirect this page to and enter the name of the target page:
    redirect checkbox
    redirect checkbox
  3. Click Apply changes.

Source editing mode

At the very beginning of the page, insert the redirect instruction and save the page:

#REDIRECT [[pagename of target page]]

There is no need to delete the content of the page. The content is simply no longer visible to readers as long as the redirect is included on the page. If you remove the code for redirecting the page, the original content will be loaded again.

Managing page redirects

  • All redirected pages on the wiki are listed on the special page Special:ListRedirects. In addition, there are pages for broken redirects as well as double redirects in the maintenance reports on the Special pages. You can navigate to them from Global actions > Special pages.
  • To maintain the quality of your wiki, you should review these pages on a regular basis and fix any broken and double redirects.
  • If you navigate to a redirected page, it shows the redirect source. A rounded arrow points to the target file:
    Redirect info on the target page
    Redirect info on the target page
  • The page "What links here" shows if redirects to a page exist. The page can be accessed via the ...all actions link in the page tools:
    what links here
    what links here
  • Clicking on the page name of the redirected page opens the original page:
    redirect link
    redirect link

Resolving double redirects

The page Special:DoubleRedirects lists all pages that are redirected from an already redirected page:

Special page "Double redirects"
Special page "Double redirects"

Let's look at the page Edit existing articles in the BlueSpice helpdesk. This page is redirected to a page Create pages that is again redirected to Manual: Create pages. The double redirect was caused by moving the page Create pages to the namespace Manual.

To resolve the double redirect, we open the page Edit existing articles in source view:

Original page
Original page

The page is not only redirected to the page Create pages but also contains a bookshelf tag. Therefore, we first check if the page is still part of the book. If it is, we need to decide if the book should include this page or the actual final target page of the redirect instead.

We now have some options to fix the redirect:

  • Redirect to the final target page
  • Redirect to a completely different page
  • Delete the page

Since the helpdesk actually has an updated page about editing, we redirect to the final target page Manual:Edit pages:

Final target page
Final target page

Sometimes, it might make more sense to simply delete the page. Before deleting an article, always check what other pages link to the page by reviewing the info under Special:WhatLinksHere/Redirects.

Related info

To submit feedback about this documentation, visit our community forum.