Redirects

In some cases, you may need to redirect a path on your site to another page on your website or to an external website. Redirects are typically used for one of two reasons:

  1. Redirecting users from an old path that no longer exists (e.g. the page was deleted) to some other page.
  2. Creating a "shortcut" path that's easy to remember that redirects to some longer, more complex URL. For example, https://princeton.edu/service redirects to the harder to remember URL for the Service Portal https://princeton.service-now.com/service.

In the first use case, adding a redirect is important, even if you've removed references to the old path on your website. Other websites may be linking directly to that old path, and search engines like Google have likely indexed the old path as well. Redirects ensure users don't receive a "not found" error page.

Automatically Created Redirects

If the path for an existing A individual item of content. For example, a page, a news article, and an event are all content items, which correspond to the Page, News, and Event content types, respectively. (Page, News, etc) is updated, a redirect is automatically added from the old path to the new one. This allows you to make changes to the path of pages without having to remember to add the redirects.

You can see the list of redirects associated with a content item by editing it and looking at the "URL redirects" section on the form. After updating the path for a content item and saving, the automatically created redirect will appear here.

The "URL redirects" section of the content item edit form, showing three existing redirects in a list.

Manually Adding and Managing Redirects

Adding a redirect manually for an existing page can be done easily by editing the page, expanding the "URL redirects" section in the sidebar, and clicking Add URL redirect (see screenshot above).

Additionally, redirects can be added and existing redirects managed by visiting Configuration > Search and metadata > URL redirects in the admin toolbar.

Add URL redirect admin screenshot

Caveats

Note

You cannot add a redirect for a path that already exists on your site. For example, if you have a page with path /some-path, you cannot add a redirect from /some-path to another page. The redirect will not work. You must delete the page you are redirecting from for the redirect to take effect.

Even if you had unpublished the page, the original URL will still prevent the redirect from working. If you would like to retain an unpublished copy of the redirected page, use the Replicate feature to make a copy of the unpublished page at a new path. As soon as you delete the original page and free up its original path, your redirect will work.