From 642b00d9eb3d5d81fb75f75f33eccd2e8fbc9a41 Mon Sep 17 00:00:00 2001 From: skeptrune Date: Sat, 16 May 2026 12:31:20 -0700 Subject: [PATCH] docs: document searchable for hidden tabs and groups 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. --- optimize/seo.mdx | 2 ++ organize/hidden-pages.mdx | 38 +++++++++++++++++++++++++++++++++++++- 2 files changed, 39 insertions(+), 1 deletion(-) diff --git a/optimize/seo.mdx b/optimize/seo.mdx index 8f8761b099..f94cafcd6f 100644 --- a/optimize/seo.mdx +++ b/optimize/seo.mdx @@ -309,6 +309,8 @@ To include hidden pages in search indexing, add `seo.indexing` to your `docs.jso } ``` +To include only the pages under a specific hidden tab or group, set `searchable: true` on that tab or group. See [Search, SEO, and AI indexing](/organize/hidden-pages#search-seo-and-ai-indexing) for details. + For documentation sites that require authentication, sitemaps and `robots.txt` files also require authenticating to access. Sitemaps exclude pages that belong to [user groups](/deploy/authentication-setup#control-access-with-groups). diff --git a/organize/hidden-pages.mdx b/organize/hidden-pages.mdx index 3d2284cfde..1140a5f67d 100644 --- a/organize/hidden-pages.mdx +++ b/organize/hidden-pages.mdx @@ -92,7 +92,11 @@ To hide a tab, add the `hidden` property for the tab in your `docs.json` file: ## Search, SEO, and AI indexing -By default, hidden pages don't appear in indexing for search engines, documentation site search, or as AI assistant context. To include hidden pages in search results and assistant context, add the `seo` property to your `docs.json`: +By default, hidden pages don't appear in indexing for search engines, documentation site search, or as AI assistant context. You have two ways to include hidden content in search and indexing. + +### Include all hidden pages + +To include every hidden page across your site in search, sitemaps, and AI context, add the `seo` property to your `docs.json`: ```json "seo": { @@ -100,6 +104,38 @@ By default, hidden pages don't appear in indexing for search engines, documentat } ``` +### Include pages under specific hidden tabs or groups + +To include only the pages under a specific hidden tab or group, set `searchable: true` on that tab or group in your `docs.json`. Use this option when you hide tabs or groups to control navigation layout but still want descendant pages discoverable. + +```json highlight={5} +"tabs": [ + { + "tab": "Storage", + "hidden": true, + "searchable": true, + "groups": [ + { + "group": "Buckets", + "pages": ["products/storage/buckets/create-bucket"] + } + ] + } +] +``` + +With `searchable: true`, descendant pages remain in: + +- Documentation site search +- `sitemap.xml` +- AI assistant context +- MCP server search results +- Search engine indexing (the `noindex` meta tag is not applied) + +The tab or group itself stays hidden from the rendered navigation. + +A page's own `hidden: true` frontmatter always takes precedence. To re-exclude a descendant group, set `hidden: true` on it without `searchable: true`. + ### Understanding hidden versus noindex The relationship between `hidden` and `noindex` is one-directional: