Skip to content

Update from support feedback: document indexing toggle side effects - #7256

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/e7ff6cf0
Open

Update from support feedback: document indexing toggle side effects#7256
mintlify[bot] wants to merge 2 commits into
mainfrom
mintlify/e7ff6cf0

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Corrects the documented behavior of the Don't index project setting, which gates llms.txt but not llms-full.txt (verified in server code), and documents that hidden: true on a version or other top-level navigation element removes all descendant pages from the site search index. Adds two symptom-named help center articles so users hitting either issue can self-serve. Includes a maintenance pass: French, Spanish, and Chinese translations of all changed pages, mirrored navigation entries, an anchor fix, and an SEO-length description fix.

Changes

  • optimize/seo.mdx: fixed the incorrect claim that the setting 404s llms-full.txt; noted that .md exports keep their /llms.txt pointer; corrected the #llms-fulltxt anchor.
  • organize/hidden-pages.mdx: new "Hide a version or other top-level navigation element" section, new table row, and a warning that hiding your only version empties site search (versions don't support searchable: true).
  • ai/llmstxt.mdx: note that the setting affects llms.txt but not llms-full.txt.
  • New help center articles: llms-txt-returns-404-but-llms-full-txt-works and site-search-returns-no-results, added to the Help center group in docs.json; shortened the site-search article description to fit the 160-character limit.
  • Mirrored all of the above into es/, fr/, and zh/, including the two new translated help center articles and matching entries in es.json, fr.json, and zh.json.

Support context


Note

Low Risk
Documentation and navigation-only changes with no application code; risk is limited to doc accuracy and cross-locale consistency.

Overview
This PR updates Mintlify docs to match actual product behavior and add self-serve troubleshooting from support tickets.

Don't index project vs llms.txt / llms-full.txt: Docs previously said the setting 404s both files. They now state it only returns 404 for llms.txt (including /.well-known/llms.txt) while llms-full.txt stays available. Related notes were added on SEO, llms.txt, and a new help article Fix llms.txt returning 404 while llms-full.txt works (plus es/fr/zh).

Hidden top-level navigation: Hidden pages now documents hidden: true on versions, anchors, dropdowns, languages, and products—including a warning that hiding your only version can empty site search (no searchable: true on versions; use seo.indexing: "all" or remove hidden). A new help article Fix site search returning no results covers the same symptom.

Navigation in docs.json and locale JSON files registers both help center pages.

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

@mintlify

mintlify Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
mintlify 🟢 Ready View Preview Sep 4, 2026, 4:29 PM

@mintlify

mintlify Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
tomee 🟡 Building Sep 4, 2026, 4:27 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

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