Broken links

Find and replace broken relative links across your spaces.

This feature is available as part of the Pro plan and Enterprise plan. To find out more, visit our pricing page.

You can add a few different types of links to your pages in GitBook. If someone has broken a relative link while making a change request by updating it or changing its location, you’ll see a notification letting you know there’s something to fix.

Broken link detection currently works only for relative links to other GitBook content in your organization. It will not detect broken links to external URLs.

If GitBook finds a broken link, you’ll see a notification in this section with a link to the page that includes the broken link. Then, simply replace or update the link with a valid one.

As you view your broken links, you can also set the scope and filter of broken links inside of the sidebar:


Current change request

This will find newly broken links within the scope of the current change request you are working in.

Current space

This will find broken links within the scope of the current space you are in.

Filter by

Show any broken or missing links in the space or change request you are in.

This filter is useful for making sure your published docs don’t link to internal content within your GitBook organization. It’ll show any links to internal, unpublished content that readers of your published content won’t have access to (i.e. links that start<organizationID>/…). You can fix them by replacing the links with the URL of the published GitBook page.

Last updated