Skip to content

SEO: index all pages, not only those in the navigation - #792

Draft
mintlify[bot] wants to merge 1 commit into
mainfrom
admin-mcp/seo-index-all-pages-86b037e
Draft

SEO: index all pages, not only those in the navigation#792
mintlify[bot] wants to merge 1 commit into
mainfrom
admin-mcp/seo-index-all-pages-86b037e

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

What

One line in docs.json: seo.indexing from "navigable" to "all".

metatags.og:image is unchanged. It appears in the diff only because update_config replaces a top-level key rather than deep-merging, so it had to be restated to preserve it.

Why

36 routable pages sit outside the docs.json navigation tree. Because seo.indexing is "navigable", search engines and AI crawlers have been told not to index any of them.

To be clear about blame: this is not a regression from #787. "navigable" is Mintlify's default, so that PR's explicit "indexing": "navigable" line was a no-op that made the existing default visible. The exclusion has been in force all along, which is why it went unnoticed.

Counting pages entries plus group root keys gives 319 navigable references against 356 .mdx files. Excluding snippets/ (includes, not routable), the 36 affected pages are:

agent-setup
sdks/python/overview, sdks/python/endpoints, sdks/python/apis
sdks/javascript/overview, sdks/javascript/endpoints
sdks/go/overview, sdks/go/endpoints
tutorials/sdks/python/get-started/{introduction,prerequisites,hello-world,running-locally}
tutorials/sdks/python/101/{hello,async,generator,error,aggregate,local-server-testing}
tutorials/sdks/python/102/{huggingface-models,stable-diffusion-text-to-image}
serverless/development/overview, serverless/endpoints/operations
get-started/products, get-started/manage-accounts
containers, fine-tune
references/billing-information, references/referrals, references/video-resources
public-endpoints/models/{cogito-671b,gpt-oss-120b}
integrations/n8n-integration
pods/storage/create-network-volumes
tutorials/serverless/run-ollama-inference
api-reference/docs/GET/docs, api-reference/docs/GET/openapi-json

None of them carry deliberate noindex frontmatter, so the exclusion looks like a byproduct of nav omission rather than an editorial choice.

This matters more than a normal indexing gap. Per Mintlify's own analytics for this deployment, ChatGPT and Claude Code are about 79 percent of agent traffic to these docs, and agent traffic is roughly 70 percent of all docs traffic. SDK reference and SDK tutorials are precisely what coding agents consume, and right now they are the pages being withheld.

Trade-off worth a reviewer's judgement

"all" also indexes the two auto-generated api-reference/docs/GET/* pages, which are thin. If those are not wanted in the index, the cleaner fix is noindex: true in their frontmatter rather than reverting this setting.

The alternative approach is adding the valuable pages to the navigation on their merits, which is better for human readers too. That is a content-architecture decision for the docs team, and it is not mutually exclusive with this change.

Verification

Diff reviewed before opening: exactly one changed value, metatags intact. No content, navigation, or redirect changes.


Generated by Claude Code

Mintlify

0 threads from 0 users in Mintlify

  • No unresolved comments

Review in Mintlify

- Updated docs.json

Mintlify-Source: dashboard-editor
@mintlify

mintlify Bot commented Aug 15, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
runpod-docs 🟢 Ready View Preview Aug 15, 2026, 3:35 AM

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.

0 participants