docs: document searchable for hidden tabs and groups#5837
Merged
Conversation
Adds the `searchable: true` option to the Hidden pages guide as the second way to expose hidden content to search, sitemap, AI context, and search engines. Cross-references it from the SEO sitemap section. Use `seo.indexing: "all"` for site-wide opt-in, or `searchable: true` on a specific hidden tab or group when only that subtree should be discoverable.
densumesh
approved these changes
May 16, 2026
This was referenced May 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds documentation for the new
searchable: trueoption on hidden tabs and groups (mintlify/mint#7768, mintlify/server#5291).organize/hidden-pages.mdx— Splits the existing "Search, SEO, and AI indexing" section into two paths: site-wideseo.indexing: "all"and per-subtreesearchable: true. Adds a worked example and the precedence rules.optimize/seo.mdx— One-line cross-reference under the sitemap section so customers findsearchablefrom the SEO entry point.Why
Without this, customers who use hidden tabs as a navigation-layout workaround (e.g. per-product isolated left navs) won't know the new opt-in exists. Hidden tabs silently strip descendant pages from search, sitemap, and AI context by default; until they discover
searchable, the merge doesn't help them.Test plan
mint broken-links— no broken linksvale optimize/seo.mdx organize/hidden-pages.mdx— 0 errors, 0 warnings (2 suggestions on pre-existing lines not touched by this change)Note
Low Risk
Low risk: documentation-only updates that clarify indexing behavior for hidden navigation content without changing product logic.
Overview
Documents a new opt-in path for indexing hidden navigation content:
organize/hidden-pages.mdxnow distinguishes between site-wideseo.indexing: "all"and per-tab/groupsearchable: true, including an example and precedence notes.Adds a cross-reference in
optimize/seo.mdxso readers of the sitemap/robots section discover thesearchable: trueoption for indexing descendants of hidden tabs/groups.Reviewed by Cursor Bugbot for commit 642b00d. Bugbot is set up for automated code reviews on this repo. Configure here.