Manage page URLs
Xperience allows you to modify URLs of web pages in the URLs section when editing a page in a website channel application. The system can also track changes of URLs and store old URLs for redirection purposes. These former URLs can be managed in the Former URLs application.
The following types of URLs are available for pages:
- System URL – Default URL generated from the page’s position in the content tree using the page’s URL slug and URL slugs of the page’s ancestors. The ‘slug’ is the part that comes at the very end of a URL, and refers to a specific page or post. For example, for the URL example.com/Articles/News/Tea-Blends/, the URL slug is ’Tea-Blends’. For more information about how page URLs are generated, see Page URL generation.
- Vanity URL – Alternative URL that can be configured and customized by marketers. Vanity URLs can serve multiple purposes:
- Marketing and branding – You can create URLs that promote branding of your products and include recognizable words to improve your marketing reach.
- Sharing – You can create a URL that is short and can be copied and shared easily, for example, on social media.
- SEO – You can improve the SEO of the page by including SEO keywords in the URL of the page.
- Canonical URL – Preferred URL of a page, i.e., the URL that is displayed to the user in the browser URL bar and is intended to be indexed by search engines. All URLs representing a page redirect to the canonical URL of the page via a “301 Moved Permanently” redirect. By default, the system URL is the canonical URL for each page. You can decide to set a vanity URL as the canonical URL of a page.
Edit page URLs
You can manage URLs of pages on the URLs tab in website channel applications.
Edit URL slugs of pages
When you create a new page, the slug is automatically generated from the page’s title. Past this point, any changes to the page title do not get reflected in the slug. You need to change it manually if required:
- Open a website channel application.
- In the content tree, select the page that you want to edit
- You may not be able to edit URL settings of every page in the content tree. This depends on the configuration of the page’s underlying content type. If you are not sure, consult with your site’s administrator.
- Make sure the page is in the Draft status or another custom workflow step.
- When a page is Published or Unpublished, you need to select Edit page or Create new version in the Content view mode. This transitions the page to the Draft step and enables editing and publishing of the page.
- In the URLs tab, edit the URL slug field in the System URL section.
- Note: Changing URL slug of a page may also affect URLs of all of the page’s descendants.
- Some characters may be forbidden from use in URLs (e.g., ‘#’, ‘/’, ‘$’, ‘&’), depending on the settings of your site. Administrators can adjust these settings in Settings → URLs and SEO → URL format.
- Save the change.
You have now successfully changed the system URL of the page. Note, that the page is now a Draft. The page needs to be published in order to be accessible under the new URL.
Edit vanity URLs of pages
Vanity URLs are optional for pages and can be set at any time after a page is created.
- Open a website channel application.
- In the content tree, select the page that you want to edit
- You may not be able to edit URL settings of every page in the content tree. This depends on the configuration of the page’s underlying content type. If you are not sure, consult with your site’s administrator.
- Make sure the page is in the Draft status or another custom workflow step.
- When a page is Published or Unpublished, you need to select Edit page or Create new version in the Content view mode. This transitions the page to the Draft step and enables editing and publishing of the page.
- In the URLs tab, edit the Vanity URL path field in the Vanity URL section.
- Some characters may be forbidden from use in URLs (e.g., ‘#’, ‘/’, ‘$’, ‘&’), depending on the settings of your site. Administrators can adjust these settings in Settings → URLs and SEO → URL format.
You have now successfully changed the vanity URL of the page. Note, that the page is now a Draft. The page needs to be published in order to be accessible under the new URL.
Select the canonical URL of pages
Canonical URL is the preferred URL of a page, i.e., the URL that is displayed to the user in the browser URL bar and is intended to be indexed by search engines.
- All URLs representing a page redirect to the canonical URL of the page via a “301 Moved Permanently” redirect.
- All system features (e.g., URL selector, rich text editor, page URL retriever, email template macros) use and return the canonical URLs of pages.
- By default, the system URL is the canonical URL for each page.
To set a vanity URL as the canonical URL:
- Open a website channel application.
- In the content tree, select the page that you want to edit
- You may not be able to edit URL settings of every page in the content tree. This depends on the configuration of the page’s underlying content type. If you are not sure, consult with your site’s administrator.
- Make sure the page is in the Draft status or another custom workflow step.
- When a page is Published or Unpublished, you need to select Edit page or Create new version in the Content view mode. This transitions the page to the Draft step and enables editing and publishing of the page.
- In the URLs tab, select the Make vanity URL canonical setting in the Vanity URL section.
- Note: This setting is only available for pages that have a vanity URL configured.
The vanity URL is now configured as the canonical URL for the page. Visitors who now access any other URL representing this page (system URL, former URLs) will be redirected to the selected vanity URL.
Canonical URL of the home page
The canonical URL of the home page of your website channel is, regardless of what URL is selected as canonical by the user, always the root URL of your website (i.e., https://example.com/) for the primary language and https://example.com/<language_name>/ for other languages.
Edit and add redirects from unpublished pages
You can edit active and scheduled redirects from unpublished pages on the URLs tab of the corresponding page. Active redirects can also be edited in the Former URLs application. The advantage of the Former URLs application is that you can see and edit all redirects in one place. If no redirect was created when the page was unpublished, you can add it it only on the URLs tab of the corresponding unpublished page.
To edit an existing redirect on the URLs tab:
- Open a website channel application.
- In the content tree, select the unpublished page you want to edit.
- On the URLs tab, select Edit in the Redirect section.
- In the sidebar, use Select existing page to change the target of the redirect to another page.
- Select Save.
You have now successfully edited the redirect. When visitors try to reach the unpublished page, they are redirected to the page you selected.
To add a redirect to an unpublished page with no redirect:
- Open a website channel application.
- In the content tree, select the unpublished page you want to edit.
- On the URLs tab, select Add redirect in the Redirect section.
- In the sidebar, use Select existing page to choose the target page of the redirect.
- Select Save.
You have now successfully added the redirect. When visitors try to reach the unpublished page, they are redirected to the page you selected.
If you want to delete a redirect from an unpublished page, you need to publish the page and go through the workflow again without selecting a page to redirect to.
URL collision prevention
A site cannot have two pages with identical URLs. Depending on the situation, the system handles collisions in two ways:
- By appending the page’s GUID at the end of the URL slug of the page. For example: https://example.com/Articles/Tea-Blends-ae64db90387143b1a4562e06b67d1970. This occurs when:
- You move a page and the destination already contains a page with a matching URL slug.
- You move a page and the destination already contains a page with a matching URL slug.
- By preventing the URL from changing and displaying an error message. This occurs when:
- You attempt to change the URL slug or a vanity URL of a page and the resulting URL matches one already in the system.
- You attempt to change the URL slug or a vanity URL of a page and the resulting URL matches one already in the system.
Former URLs
The system can automatically keep track of page URL changes by storing old URLs and handling redirects to the current URLs. You can see and manage these redirects in the Former URLs application. Redirects created by unpublishing or deleting pages are stored and handled by default. You can additionally configure the system to create former URLs when a URL is edited and to redirect to the current URLs.
When a redirect target of a former URL is changed, all redirects that target the corresponding page are also automatically adjusted.
Set up Former URLs to store edited URLs
To configure the system to automatically store edited URLs as former URLs and handle redirects to current URLs:
- Open the Channel management application.
- Select the website channel for which you want to configure Former URLs to store and handle edited URLs.
- Open Channel settings.
- Select the Store edited URLs as former URLs setting.
- Save the changes.
Former URLs are now created when URLs are edited in the given website channel. Every time a former URL is requested, the system returns a “301 Moved Permanently” response and redirects to the new URL of the page.
To access a list of all stored old URLs for the website, together with the current URL paths to which they are redirected, open the Former URLs application.
Former URLs scenarios
Former URLs are created when you unpublish or delete a page and also create a redirect from the page. Additionally, you can configure the system to create former URLs when modifying page URLs.
Former URLs are always created when: | If configured to store edited URLs, former URLs are created when: |
|
|
Former URLs are NOT created when:
- Deleting a page without creating a redirect.
- Deleting a page without creating a redirect permanently destroys and removes all former URLs pointing to that page.
- Unpublishing a page and choosing to serve content in the fallback language.
- Unpublishing a page without creating a redirect.
- Administrators perform certain global changes, for example changing the domain of a website channel.
- Changing a language code name.
- Changing the Primary language setting for a website channel.
Changing the language code name or the primary language setting breaks all former URLs for the corresponding language variants of pages.
Former URLs actions
Edit redirects from unpublished and deleted pages
This action is available only for former URLs created by unpublishing or deleting a page.
To edit a redirect:
- Open the Former URLs application.
- Select the former URL you want to edit.
- Use Select existing page to select the new target of the redirect.
- Confirm the changes with the Select button.
The redirect now targets the page you selected.
Remove former URLs created by editing URLs
This action is available only for former URLs created by editing a page’s URL or by deleting a page. Their remove button is active (). Former URLs that are created by unpublishing pages have a disabled delete button () and can’t be deleted.
To remove a former URL:
- Open the Former URLs application.
- Remove () the specific former URL.
The former URL is now permanently removed.