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:

1. Open a website channel application.
2. 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.
3. 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.
4. 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.
5. 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.

1. Open a website channel application.
2. 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.
3. 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.
4. 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:

1. Open a website channel application.
2. 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.
3. 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.
4. 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.

URL collision prevention

A site cannot have two pages with identical URLs. Depending on the situation, the system handles collisions in two ways:

1. 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.
     
2. 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.
     

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.

Set up former URLs

To set up the former URLs feature in your project:

1. Open the Channel management application.
2. Select the website channel for which you want to set up former URLs.
3. Open Channel settings.
4. Select the Store former URLs setting.
5. Save the changes.

Former URLs are now set up for 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 change a page’s URL by:

• Editing the URL slug for the given page or one of its parent pages.
  • The former URL is created only after you publish the page with the new URL.
• Move the page across the content tree.
  • In this case the former URL is created immediately.
• Editing the vanity URL path for the given page.
  • The former URL is created only after you publish the page with the new URL.

Former URLs are NOT created when:

• Deleting a page.
  • Deleting a page permanently destroys and removes all former URLs pointing to that page.
• 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.

Remove former URLs

To remove a former URL:

1. Open the Former URLsapplication.
2. Remove () the specific former URL.

The former URL is now permanently removed.