Announcement: URLs for multi-variant docs sites are changing

24 September — We’re changing the structure of URLs for sites with multiple variants — and we’ve set up automatic redirects to ensure all links still work as expected

💡 What’s changing?

Quick summary: URLs for docs site variants, such as docs.mycompany.com/v/fr/ will be accessible at docs.mycompany.com/fr/starting 26 September. We are removing the /v/ to simplify the structure of URLs.

If you’ve published multiple spaces in the same site, you might’ve noticed that variant URLs have a /v/ between the domain and the slug. This update will remove that to simplify the URL for your readers, and make it easier for people moving their existing published into GitBook.

The result will be that a URL such as docs.mycompany.com/v/fr/ will now be accessible at docs.mycompany.com/fr/ .

All depreciated URLs (e.g. docs.mycompany.com/v/fr/ ) will automatically redirect to the new canonical URLs.

What does this mean for your content?

In most cases, this should not be a breaking change — you may not even notice it’s happened. The old URLs will still work by redirecting to the new URL.

However, if you’ve set up some custom logic with there URLs, this change may require you to update your setup.

We’re proactively reaching out to customers who we know may be affected by this. But if you have any questions about your custom setup and how this change may affect it, please reach out to our support team — they’d be happy to help.

Last updated