Skip to main content Skip to secondary navigation

Managing URL redirects and URL aliases

Site managers have the ability to manage URL redirects and URL aliases across their site.

URL Redirects

A URL redirect allows users to redirect from an old URL to a new URL.

For example, if you had an outdated "About" page, and created a new "About Us" page with a different URL, you could add a URL redirect so that anyone using the outdated URL could still be pointed to the new URL/page.

URL redirects are created automatically when you update a page title or URL, which ensures that older links will still redirect to the correct location, even if the URL path was adjusted.

Managing URL redirects

A full listing of your site's URL redirects can be found on the Redirect admin page at [your site URL]/admin/config/search/redirect. From this page, you can add new redirects, edit or delete current redirects, and filter your redirects.

  1. In the administrative toolbar hover over Configuration > Search and metadata > URL redirects.

Adding a new URL redirect

  1. If you are within the Redirect admin page, click Add redirect. Otherwise, hover over Configuration > Search and metadata > URL redirects > Add redirect in the admin toolbar.
    Add redirect page
  2. Enter the source path in the Path field.
  3. Enter the destination path in the To field
    • The destination can be an internal path if it's on your site, or a full external URL if you want to redirect to an external website.
  4. Almost all the time, you will want to leave Redirect status set to "301 Moved Permanently". You can learn more about HTTP redirect status codes at https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#3xx_Redirection
  5. Click Save.

Managing the URL redirects on an individual page

You can also manage the URL redirect for an individual page by navigating to its node edit page, and clicking the URL redirects tab in the sidebar. From this screen you can add new URL redirects, or edit/delete existing redirects.

Add URL redirect within individual page

URL Aliases

A URL alias defines a different name for an existing URL path - for example, the alias 'about' for the URL path 'node/1'. A URL path can have multiple aliases.

Managing URL Aliases

A full listing of your site's URL aliases can be found on the admin page at [your site URL]/admin/config/search/path. From this page, you can add new aliases, edit or delete current aliases, and filter your aliases.

  1. In the administrative toolbar hover over Configuration > Search and metadata > URL aliases.

Adding a new URL Alias

  1. If you are within the URL Alias admin page, click Add alias. Otherwise, hover over Configuration > Search and metadata > URL aliases in the admin toolbar.
  2. Specify the existing path you wish to alias in the System path field.
  3. Specify your desired alternate path in the URL alias field.
    Add URL alias

Adjusting the URL alias on an individual page

You can also manage the URL alias for an individual page by navigating to its node edit page, and clicking the URL alias tab in the sidebar. To create a custom alias, uncheck Generate automatic URL alias and enter your desired alias in the URL alias field.

Add URL alias within individual page