Skip to content

Update from code changes: document searchable frontmatter#6312

Merged
densumesh merged 5 commits into
mainfrom
mintlify/7e6fb8fc
Jun 29, 2026
Merged

Update from code changes: document searchable frontmatter#6312
densumesh merged 5 commits into
mainfrom
mintlify/7e6fb8fc

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the new searchable page frontmatter field that lets authors exclude a page from in-product docs search and the AI assistant context while keeping it indexable by external search engines.

Changes

  • organize/pages.mdx: add a searchable ResponseField next to noindex.
  • optimize/search.mdx: add an "Exclude a page from search" section with usage guidance and a code example, plus updated keywords.
  • organize/hidden-pages.mdx: add a searchable: false row to the visibility/indexing table and cross-link from the "hidden versus noindex" explainer.
  • Mirrored all updates in the fr, es, and zh translations.

Context

A new searchable?: boolean field was added to page frontmatter. Setting searchable: false excludes the page from in-product docs search and the AI assistant context. Sitemap, robots, and external SEO behavior are unchanged. This is the inverse of noindex, which removes a page from both internal and external indexing.

Update history

  • Initial: documented the new searchable frontmatter field across en/fr/es/zh (organize/pages.mdx, optimize/search.mdx, organize/hidden-pages.mdx).
  • Tightened a long usage-guidance sentence in the new "Exclude a page from search" section across en/fr/es.
  • Clarified that searchable: false also excludes the page from the AI assistant context (Inkeep ingestion), based on the runtime implementation in https://github.com/mintlify/server/pull/6226. Updated the description, supporting bullets, the visibility/indexing table row, and the "hidden versus noindex" cross-link across en/fr/es/zh.

Note

Low Risk
Documentation-only MDX changes with no runtime or configuration impact.

Overview
Documents the new searchable page frontmatter option across en, es, fr, and zh.

Authors can set searchable: false to drop a page from in-product search and AI assistant context while keeping it in the sidebar, sitemap, and external SEO—contrasted with noindex, which also blocks external indexing.

Updates add a searchable ResponseField on the pages reference, a new “Exclude a page from search” section on the search guide (example + keywords), and—where those pages already had the matrix—a searchable: false table row plus guidance in the hidden vs. noindex explainer with cross-links.

Reviewed by Cursor Bugbot for commit a86571a. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Tightened the searchable frontmatter field description across English, French, and Spanish

Source PRs

@densumesh densumesh merged commit 756d730 into main Jun 29, 2026
5 checks passed
@densumesh densumesh deleted the mintlify/7e6fb8fc branch June 29, 2026 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant