Search the Confluence 4.1.x Documentation:

Index
Downloads (PDF, HTML & XML formats)
Other versions

This documentation relates to Confluence 4.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.
Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

To rename an existing page, you require 'Edit Pages' permission which is assigned by a space administrator from the Space Administration screens. See Space permissions or contact a space administrator for more information.

To rename a page:

  1. Go to a page in the space, and click Edit at the top to view the page in 'Edit' mode.

  2. Change the page title as required.
  3. Click Save.
Notes
  • Confluence will automatically update all internal links to point to your new page title. This only works for page links that use the relative link syntax, for example [Renaming a Page].
  • In macros, page links will not be updated. You need to update these manually.
  • Links from external sites will be broken, unless they use the page's permanent URL.
Related Topics

Linking Pages
Working with Pages

Take me back to Confluence User's Guide

Labels:
None
Edit Labels

10 Comments

Hide/Show Comments

  1. Nov 27, 2007

    Bob Swift

    Please clarify:

    1. Confluence will automatically change all internal links to point to your new page title.

      I read that to mean any page reference using page linking syntax like [page] will be renamed. And the rename will occur whether or not the reference is inside a macro body or not.

    2. Explicit references to your page title in macros will not be changed. You need to change these manually.

      I read that to mean that macro parameters that refer to pages like the {include-page} macro will need to be changed manually.

    1. Nov 28, 2007

      Mei Yan Chan

      Hi Bob,

      You clarification is right on both accounts.

      Regards,
      Mei

      1. Feb 25, 2008

        Jeff Schnitter

        It is more than just macro parameters that need to be changed manually. Pages do not appear to be renamed in any macro body. For example if I use the table-plus macro as follows and rename Page A to Page B, the reference to Page A will not be updated.

        {table-plus}
|| Page Name || Link    ||
 | Page A     | [Page A] |
{table-plus}

        1. Feb 25, 2008

          Choy Li Tham

          Hi Jeff,

          Thanks for reporting this. I have found a similar bug which is currently being tracked at the following:

          The bug report above stated that links exists within some macros do not get changed when a page is renamed. Feel free to add comments on the bug report above to truly reflect the problem that you are having as well as add yourself as a watcher for future updates.

          Regards,
          Choy Li

  2. Feb 26, 2008

    Anonymous

    I am finding that when i have something like [my page|space:my space|tooltip for space] the link breaks when the page is renamed. Why is this happening? Does this mean that all my links should be name like this: [pagename]. That means that any page that isn't a child page breaks?!?!!? Thanks for clarifying

    1. Feb 27, 2008

      Anonymous

      Me again. I have noticed that if I do not specify a tooltip and keep it at: [my page|space:this page] then the link doesn't break when renamed. Is this a bug or should I be doing it differently?

      1. Mar 02, 2008

        Choy Li Tham

        Hi,

        Thanks for reporting this. I believe you have encountered a similar bug that is currently being tracked at:

        The bug report above stated that a link with a tooltip broke when the linked page is renamed. Please add yourself as a watcher to get its notifications and feel free to add a comment on the bug report above to truly reflect the problem that you are having.

        Regards,
        Choy Li

        1. Mar 10, 2008

          Anonymous

          Is anyone else experience this problem? If you are could you see the above bug tracking and vote for this topic? Thanks

  3. Dec 20, 2010

    Anonymous

    Is it possible to rename a page title without changing the file/URL name of the page. We need to change the title of a page, but have external links pointing to it that we cannot update.

    1. Dec 29, 2010

      Husein Alatas [Atlassian]

      Hi,

      It's best to use the permanent link (Tiny Link) for your case. The Tiny Link will always stay the same for each Page, regardless the Page Title. Please refer to this page:Linking to Confluence Pages from Outside Confluence for more details.

      Alternatively, you can point the link using the Page ID. For example, this current page: Renaming a Page would become like this:

      Hope this helps (smile).

      Cheers,
      Husein