Remove hidden site spaces from navigation

[nolannbiron]

Introduces filtering of hidden site spaces when parsing site context, sections, and groups. Ensures only visible site spaces are included.

[changeset-bot]

🦋 Changeset detected

Latest commit: 56b3aa2

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

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-2gfwql05m-gitbook.vercel.app	✅
Cloudflare	https://3ae6089f-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

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

[Copilot]

Pull Request Overview

This PR introduces filtering to remove hidden site spaces from navigation structures while preserving the current site space even if it's hidden. This ensures only visible site spaces are shown in the navigation while maintaining context accuracy for the active space.

Key changes:

• Added filterHiddenSiteSpaces and filterHiddenSiteSpacesFromSections utility functions to filter hidden spaces
• Modified parseSiteSectionsAndGroups to apply filtering recursively across sections and groups
• Updated fetchSiteContextByIds to filter hidden spaces for both siteSpaces and sections structure types

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
packages/gitbook/src/lib/context.ts	Adds filtering functions and applies them to site context parsing to exclude hidden site spaces from navigation
.changeset/three-melons-enjoy.md	Documents the patch-level change for removing hidden site spaces from navigation

Comments suppressed due to low confidence (1)

packages/gitbook/src/lib/context.ts:422

• The checkIsRootSiteContext function uses unfiltered sections from getSiteStructureSections, which may include hidden site spaces. This creates inconsistency with the filtered context.sections data. The function should either use the already-filtered sections from the context or apply the same filtering logic to ensure consistency.

            return getSiteStructureSections(structure, { ignoreGroups: true }).some(
                (structure) =>
                    structure.default &&
                    structure.id === context.sections?.current.id &&
                    structure.siteSpaces.some(
                        (siteSpace) => siteSpace.default && siteSpace.id === context.siteSpace.id
                    )
            );

---

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

[argos-ci]

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

Build	Status	Details	Updated (UTC)
customers-v2 (Inspect)	👍 Changes approved	28 changed	Nov 18, 2025, 2:57 PM
v2-cloudflare (Inspect)	👍 Changes approved	7 changed	Nov 17, 2025, 10:13 PM
v2-vercel (Inspect)	👍 Changes approved	2 changed	Nov 18, 2025, 3:01 PM

[Copilot]

Pull Request Overview

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

---

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