From 671d4b2c1a0161a91b31c0e20715b670c817c7f8 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Tue, 10 Jun 2025 09:24:22 -0700 Subject: [PATCH] update hidden pages --- guides/hidden-pages.mdx | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/guides/hidden-pages.mdx b/guides/hidden-pages.mdx index 9c4441c07..ad75ec40a 100644 --- a/guides/hidden-pages.mdx +++ b/guides/hidden-pages.mdx @@ -4,9 +4,11 @@ description: "Exclude pages from your navigation" icon: "eye-closed" --- -Hidden pages are removed from your site's navigation while remaining publicly accessible to anyone who knows their URL. +Hidden pages are removed from your site's navigation but remain publicly accessible to anyone who knows their URL. -Use hidden pages for content that you want to be accessible on your site, but not discoverable through the navigation. For content requiring strict access control, you must configure [authentication](/authentication-personalization/authentication-setup). +Use hidden pages for content that you want to be accessible on your site or referenced as context for AI tools, but not discoverable through the navigation. + +For content requiring strict access control, you must configure [authentication](/authentication-personalization/authentication-setup). If you want to hide pages for specific groups of users, use personalization to control [page visibility](/authentication-personalization/overview#page-visibility). @@ -18,14 +20,14 @@ A page is hidden if it is not included in your `docs.json` navigation. To hide a Some navigation elements like sidebars, dropdowns, and tabs may appear empty or shift layout on hidden pages. -## Search and SEO +## Search, SEO, and AI context -By default, hidden pages are excluded from indexing for search engines and internal search within your docs. To include hidden pages in search results, add this setting to your `docs.json`: +By default, hidden pages are excluded from indexing for search engines, internal search within your docs, and as context for the AI assistant. To include hidden pages in search results and as context for the assistant, add the `seo` property to your `docs.json`: -``` -"seo" { - "indexing": all +```json +"seo": { + "indexing": "all" } ``` -To exclude a specific page from search, add `noindex: true` to its frontmatter. +To exclude a specific page, add `noindex: "true"` to its frontmatter.