Fix an issue where content refs to spaces outside of site was resolving with share links

[taranvohra]

The share key is preserved only within spaces of the site while resolving content refs. Otherwise it's reset

[changeset-bot]

🦋 Changeset detected

Latest commit: a4a0864

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
gitbook	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[linear]

RND-9180 Incorrect URL linking on sites with share link

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-ni6uog0b3-gitbook.vercel.app	✅
Cloudflare	https://4fe985c2-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-ni6uog0b3-gitbook.vercel.app/url/gitbook.com/docs	https://4fe985c2-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-ni6uog0b3-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://4fe985c2-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2 (Inspect)	✅ No changes detected	-	Jan 7, 2026, 5:02 AM
v2-cloudflare (Inspect)	👍 Changes approved	18 changed	Jan 7, 2026, 5:06 AM
v2-vercel (Inspect)	👍 Changes approved	20 changed	Jan 7, 2026, 5:06 AM

[Copilot]

Pull request overview

This PR fixes an issue where content references to spaces outside of a site were incorrectly resolving with share link tokens. The fix ensures that share keys are only preserved for links within the same site, not for cross-site references.

• Modified the resolveContentRefInSpace function to conditionally pass the share key only when the target space exists within the current site
• Added E2E tests to verify correct behavior for both same-site and cross-site links with share tokens
• Refactored the foundSiteSpace lookup to avoid duplication

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
packages/gitbook/src/lib/references.tsx	Fixed logic to conditionally pass shareKey based on whether the target space is in the current site, and refactored duplicate code
packages/gitbook/e2e/internal.spec.ts	Added E2E tests to verify share link tokens are preserved for same-site navigation but not for cross-site links
.changeset/silver-ideas-relax.md	Added changeset describing the bug fix

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.