Skip to content
The Docs Report
Tuesday, November 17, 2026NewsletterRSS

GitBook Now Checks Links to Other Sites and Syncs Fixes With Redirects

GitBook's Oct. 21 update scans outbound links for dead domains and timeouts, ties findings to redirects and keeps links intact in MCP edits.

2 min read

GitBookAnalyticsMCP

Isometric 3D illustration of glossy cobalt blue globes on stands on a tiled floor

GitBook’s broken links report now checks links that point to other websites, not only pages on the same site, GitBook said in its Oct. 21 changelog. GitBook rechecks these outbound links regularly. Each finding says what failed.

Findings name the failure

Each outbound finding is labeled as an unresolved domain, a timeout or a broken redirect. That separates a dead page from a temporary outage. Placeholder and example domains are not flagged. When a whole domain stops resolving, GitBook groups every link to it into one finding that lists the affected pages.

GitBook Agent can fix broken outbound links. It creates one change request that updates all broken outbound links in a space. A person reviews it before it publishes.

Redirects now close findings

Every finding on the Broken links screen is now open, resolved or ignored. Adding a redirect, including a wildcard or a bulk import, resolves the broken links it covers. Removing the redirect reopens them. Each finding offers only the actions that fit its current state.

The report debuted Oct. 6. It covered pages on the same site and suggested redirects.

Editing a page through the GitBook MCP server now keeps existing hyperlinks, GitBook said. Internal links use references that survive the edit. API updates to change request content can name the revision the caller expects to change. The update applies only if the content has not changed since the caller read it. The MCP server walks AI tools through these checked updates.

Smaller changes

  • Analytics reports now end at the last full UTC day.
  • Site creators can edit site redirects.
  • On existing sites, GitBook Agent creates new sections and variants as drafts.
  • Section groups in site navigation accept adaptive content conditions.

Key takeaways

  • Broken links now covers links to other websites and says whether each one failed on the domain, a timeout or a redirect.
  • One Agent change request can fix every broken outbound link in a space.
  • Adding or removing a redirect updates matching findings automatically.
  • MCP and API edits now keep hyperlinks and refuse stale updates.

The take

We think the revision check is the most useful item here. An edit that applies only when the page is unchanged since it was read stops an agent from overwriting a colleague’s work with an old copy.

The outbound checks need a lighter touch. A timeout can mean a slow server on a bad day. One check cannot tell the difference. GitBook rechecks links regularly, but a person still decides whether a link is dead.

We’d run the Agent fix on one space, read the change request line by line, and ignore any finding that only timed out once.