Skip to content

docs: add indexing comparison table to hidden pages#6146

Open
Bhavysinghal wants to merge 3 commits into
mintlify:mainfrom
Bhavysinghal:feat/hidden-pages-indexing-table
Open

docs: add indexing comparison table to hidden pages#6146
Bhavysinghal wants to merge 3 commits into
mintlify:mainfrom
Bhavysinghal:feat/hidden-pages-indexing-table

Conversation

@Bhavysinghal

@Bhavysinghal Bhavysinghal commented Jun 11, 2026

Copy link
Copy Markdown

What changed

Added a comparison table to the "Search, SEO, and AI indexing" section of organize/hidden-pages.mdx.

Why

The section explained the behavior of hidden, noindex, searchable, and seo.indexing properties across multiple paragraphs. A table makes it significantly faster to scan and compare behaviors at a glance.

What the table covers

  • 4 properties: hidden: true, noindex: true, searchable: true, seo.indexing: "all"
  • 5 scenarios: Sidebar Navigation, Site Search, Sitemap, Search Engine Indexing, AI Assistant Context

How to verify

Visit the live preview and navigate to:
/organize/hidden-pages → "Search, SEO, and AI indexing" section

image

Closes #5961


Note

Low Risk
Docs-only change with no runtime or configuration behavior changes; table content matches existing guidance on the same page.

Overview
Adds a comparison table at the start of the Search, SEO, and AI indexing section in organize/hidden-pages.mdx, right after the introductory paragraph.

The table maps hidden: true, noindex: true, searchable: true (on hidden tabs/groups), and seo.indexing: "all" to five outcomes: sidebar navigation, site search, sitemap, search engine indexing, and AI assistant context. It condenses behavior that was already described in the surrounding sections into a scannable reference.

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

@ethanpalm ethanpalm left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @Bhavysinghal, thanks for creating a PR to help improve the Mintlify docs!

This table looks really helpful. I just requested a small change to fit our documentation style (we don't use emoji in the docs), but after that's incorporated we can get this merged.

Comment thread organize/hidden-pages.mdx Outdated
Comment on lines +97 to +104
The following table summarizes how each property affects page visibility and indexing:

| Property | Sidebar Navigation | Site Search | Sitemap | Search Engine Indexing | AI Assistant Context |
|---|---|---|---|---|---|
| `hidden: true` | ❌ Hidden | ❌ Excluded | ❌ Excluded | ❌ Excluded | ❌ Excluded |
| `noindex: true` | ✅ Visible | ✅ Included | ✅ Included | ❌ Excluded | ❌ Excluded |
| `searchable: true` (on hidden tab/group) | ❌ Hidden | ✅ Included | ✅ Included | ✅ Included | ✅ Included |
| `seo.indexing: "all"` (in `docs.json`) | ❌ Hidden | ✅ Included | ✅ Included | ✅ Included | ✅ Included |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The following table summarizes how each property affects page visibility and indexing:
| Property | Sidebar Navigation | Site Search | Sitemap | Search Engine Indexing | AI Assistant Context |
|---|---|---|---|---|---|
| `hidden: true` | Hidden | Excluded | Excluded | Excluded | Excluded |
| `noindex: true` | Visible | Included | Included | Excluded | Excluded |
| `searchable: true` (on hidden tab/group) | Hidden | Included | Included | Included | Included |
| `seo.indexing: "all"` (in `docs.json`) | Hidden | Included | Included | Included | Included |
The following table summarizes how each property affects page visibility and indexing:
| Property | Sidebar navigation | Site search | Sitemap | Search engine indexing | AI assistant context |
|---|---|---|---|---|---|
| `hidden: true` | Hidden | Excluded | Excluded | Excluded | Excluded |
| `noindex: true` | Visible | Included | Included | Excluded | Excluded |
| `searchable: true` (on hidden tab/group) | Hidden | Included | Included | Included | Included |
| `seo.indexing: "all"` (in `docs.json`) | Hidden | Included | Included | Included | Included |

Just a small style edit to remove the emojis.

@Bhavysinghal

Copy link
Copy Markdown
Author

Hi @ethanpalm, thank you for the feedback and for taking the time to review! I've addressed both points — removed the emojis and updated the column headers to sentence case. Please let me know if anything else needs adjusting!

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.

Doc enh. - impact of noindex, hidden, and searchable

2 participants