This page describes how to handle redirects for different scenarios involving multiple projects and custom domain changes. For the basics on redirects, see Error Pages.
Note all redirects must be relative paths (i.e., paths that start with a "/" and that come after the main site domain).
Configure redirects on your project's dash at:
If you're working in a single project, you typically author redirects using the following relative path pattern:
For example, if you had a page in your Guides section named "intro-page", and you changed it "getting-started," you'd author this line:
/docs/intro-page -> /docs/getting-started
If you change your custom domain (for example, because you are upgrading to enterprise), then you can't simply create redirects in your project's dash. Instead, your company's developers or site admins have to create the 301 redirects on your side. For example, if you serve your site using Apache, you set up 301 redirects in the server's .htaccess config file.
If you have an Enterprise group project with multiple child projects, configure redirects at:
In other words, you configure all redirects on the parent project's dashboard, not on the child projects.
You author redirects using the following relative path pattern:
For example, if you renamed a page from "intro-page" to "getting-started" in the Guides section of the product-1 project, you'd author this line:
/product-1/docs/intro-page -> /product-1/docs/getting-started
To test for broken links once you create redirects, you can use third-party tools. For more information see Link to pages.
Remember to update redirect when you upgrade to a group project
If you're upgrading a project to become an Enterprise group project, remember to remove page redirects from all child projects, and remember to update all page slug redirects with the project subdomain. In other words, your old relative paths in the child projects were:
and your new relative paths in the parent project are:
For more information see Upgrading to a Group Project.
Updated 12 months ago