2.5 Rename/move

About moving pages

A wiki page can only be renamed by moving it. Moving is necessary, since the web address of the page changes during renaming. Normally, there are many links to a wiki page. It is therefore important that these links still work after renaming the page.

A page can be moved with or without redirecting the original page. Let's take a closer look at the differences.

What happens when you move a page?

When you move a page:

  • you rename the page name and thus the page title
  • the page content is displayed on the new page
  • the version history of the original page is transferred to the new page

If you move from the original page to the new page, an additional page with the old page name will be created. This page then serves as a redirect to the new page. If you do not create a redirect, the original page is simply replaced. In this case, you should check and update the links to the old page on your wiki.

What links here

Before you move a page, you should see if other pages link to that page name. To do this, go to What links here under ...all actions in the page tools. If many links are listed here, you should create a redirect when moving the page.

What links here
What links here

The following diagram shows how to rename an "Emobile" page to a page called "Electric Vehicles" page:

drawio: Seite_verschieben


How do I move a page?

Go to the page tools menu item "Manage page> Move":


  1. Click Move.
    Actions menu
    Actions menu
  2. Enter a new page name. If you move the page to a different namespace, you need to include the namespace prefix as well.
    Moving a page to a different namespace and renaming the page
    Moving a page to a different namespace and renaming the page
  3. Provide a reason why why it was necessary to move the page (optional). This reason is shown in the logs of the wiki.
  4. Leave a redirect behind: Depending on the linking status or purpose of a page, you now have to decide whether to move the page with or without forwarding.
  5. Watch source page and target page: Specify whether you want to put the source and landing pages on your watch list when redirecting.
  6. Click Done. The page has been moved.
    Successfull move
    Successfull move

Move with redirect

It makes sense to create a redirect in the following cases:

  • The original page is linked to many other sites (e.g., from other websites or other internal wiki sites).
  • The title of the original page is sometimes used in the search and the page should be found either way.
  • The page is returned as a result of an SMW query . In that case, due to a bug, the original page needs to be deleted manually after the page move.   -v4.3.2

Move without redirect

In these cases, it makes sense to move without forwarding:

  • A spelling error is corrected in the title. There are only a few links to the page and they are easy to find and replace.
  • The original title should not appear in the search.
  • An unnecessary redirection via a forwarding page should be avoided.


Updating references to the page

If no redirect was created when the page was renamed, it is sometimes necessary to check if existing links to the original page exist in your wiki. These must then be adapted accordingly to the new page name, so that the page is newly networked.

Users with administrator permissions can go to the page Special:Replace Text to find references to the previous page name.

Enter the original page title under "Existing text" and the new page title under "Replacement text":

Replace text
Replace text

Select all wiki sections using the "All" button to find existing references to the original page:

Replace text - settings
Replace text - settings

If you click on "Continue" the text will not be replaced yet. First, an overview page with the results found will be displayed. Check which of the results you want to replace and check the box. Click "Replace" to perform the replacement:

Replace old page name
Replace old page name

The last page now confirms that the wiki is now completing the text replacements:

Confirmation of text replacements
Confirmation of text replacements

Your wiki is now correctly linked again and the editing of the page renaming is completed. Depending on the number of replacements, it may take a while before the changes are actually visible. The changes made by this special page are collected in a queue, which is gradually processed in the background.


Related info




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