Wiki source code of Page Rename Wizard
Last modified by Eleni Cojocariu on 2026/08/11 12:11
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | When [[moving/renaming>>documentation.xs.user.base.page.page-refactoring-operations.move-rename.WebHome]] a Page, the Rename Page Wizard opens, as follows: | ||
| 2 | |||
| 3 | {{image reference="page-rename-wizard-simple-user.png" size="extra" alt="The Wizard that helps you move/rename a page"/}} | ||
| 4 | |||
| 5 | |=Option/Field|=Description|=Image | ||
| 6 | |Source|Displays the path of the Page, the hierarchy of the Page through the [[breadcrumb>>documentation.xs.user.base.page.view-page.breadcrumb.WebHome]].| | ||
| 7 | |Preserve children|If child Pages exist, you can choose to move the child Pages together with their parent to preserve the hierarchy, or keep them in place. If kept in place, the children become “orphans”: they remain accessible through the same URLs, but lose their parent until you create a new one. | ||
| 8 | |[["Update links">>||anchor="HWhycan27tIseethe22Updatelinks22and22RenameasTerminalPage22checkboxes3F"]]|There are still some [[limitations>>documentation.xs.user.base.page.page-refactoring-operations.move-rename.limitations.WebHome]] when renaming a Page, related to updating references so that they point to the Page’s new location. Pages where references have been updated will display a [[history entry>>documentation.xs.user.base.page.view-page.view-history.history-tab.WebHome||anchor="HWhatdoesitmeanseeing201CRenamedback-links201Dinthehistory3F"]].|{{image reference="update-links.png" size="large" alt="Dialog showing the option to automatically update backlinks and internal references when renaming a page."/}} | ||
| 9 | |"Create an automatic redirect"|[[Adds an Object>>documentation.xs.user.base.page.edit-page.edit-object-editor.attach-remove-objects.WebHome]] of type ##XWiki.RedirectClass## to the deleted Page, automatically redirecting visitors to the new target. This is useful for preserving access when there are [[external links>>||anchor="HWhatisaninternallinkvs.anexternallink3F"]] pointing to the original Page or its [[child Pages>>documentation.xs.user.base.page.nested-pages.relations.WebHome]]. Without the redirect, those external links would break after the rename.| | ||
| 10 | |New Title|Allows you to type a new [[title for the Page>>documentation.xs.user.base.page.edit-page.titles-names.WebHome||anchor="HPageTitles"]].| | ||
| 11 | |(% rowspan="2" %)New Location|Allows users to choose the new location of the Page within the hierarchy. [[Simple users>>documentation.xs.user.base.page.edit-page.simple-advanced.WebHome||anchor="HSimpleMode"]] can select a [[parent Page>>documentation.xs.user.base.page.nested-pages.relations.WebHome]] using the Location Picker icon, which opens a modal displaying the Page hierarchy. Clicking a Page sets it as the new parent.|{{image reference="select-new-location.png" size="medium" alt="The modal displays the hierarchy of the pages"/}} | ||
| 12 | |{{id name="HNewLocation"/}}[[Advanced users>>documentation.xs.user.base.page.edit-page.simple-advanced.WebHome||anchor="HAdvancedMode"]] also have a pencil icon that lets them manually edit the page path using the [[Page reference>>Documentation.UserGuide.Features.DocumentLifecycle.WebHome||anchor="HInformation"]] syntax in the "Parent" field, and they can modify the [[name of the page>>documentation.xs.user.base.page.edit-page.titles-names.WebHome||anchor="HPageNames"]] in the "Name" field.|{{image reference="rename-page.png" size="medium" alt="Advanced rename interface with fields for editing the parent reference and manually specifying the page name."/}} | ||
| 13 | |Rename as Terminal Page|Allows you to mark the Page as a [[terminal Page>>documentation.xs.user.base.page.nested-pages.relations.WebHome]].|{{image reference="rename-terminal-page.png" size="large" alt="The rename as terminal page checkbox."/}} |