This page gets you here: a visitor who opens an old docs path is sent to the article as it is now.
When you change a slug or move something in the tree, the system often adds a row for you. This page is for checking those rows and adding one by hand.
Do not put the two kinds of redirect on the wrong page
| Use | Admin |
|---|---|
An old path under the docs prefix (/docs/...) | This page, Docs redirects (/admin/docs/redirects) |
| Any other old URL on the marketing site | Public path redirects |
A docs redirect is one hop: the old path jumps once, and the target is that article’s current public path.
Where
The title is Docs redirects. The breadcrumb is Docs spaces → Docs redirects. You can go Back to spaces.
What the system handles for you
- An article or folder changes its slug, or moves to another folder.
- An owner changes the docs prefix in type settings (for example
/docs→/help): existing redirects’ old paths are rewritten when possible. Afterward, check this page.
The empty list says there are no redirects yet, and that some rows are maintained automatically when a slug or the prefix changes.
Add one by hand
The section is Add redirect.
| Field | What it does |
|---|---|
| Old path | From the site root, including the docs prefix, for example /docs/old-guide |
| Space | The space the target lives in |
| Target page | The article to send people to |
Press Add redirect. On success the notice is Redirect created. One old path can have only one row.
The list columns are old path, space, target, status, and delete. Delete asks you to confirm first.
Check
- In a private window, open the old path. You should land on the new article (the URL becomes the current path).
- It should not hop twice before it stops.
When it sticks
| What you see | What to do |
|---|---|
| You filled in a site-path redirect and it is still 404 | That path belongs to docs. Fill it in on this page |
| The old path format is wrong | It must include the prefix, such as /docs/.... Do not write only old-guide |
After you change the prefix, /docs is still the old one | Check whether this list was rewritten. If not, add a row by hand |
Related
- Publish a document
- Manage spaces (type settings change the prefix)
- Public path redirects