Docs SEO – Max search visibility (Mintlify)
Best practices so docs.ai2fin.com stays fully indexable and ranks well. See Mintlify: Hidden pages and Mintlify: SEO.Hidden vs noindex (use correctly)
| Goal | Use | Effect |
|---|---|---|
| Page in nav + in Google | Don’t set hidden or noindex | Default: indexed, in sitemap, in AI context. |
| Page in nav, NOT in Google | noindex: true in frontmatter only | Visible in sidebar; excluded from search + sitemap. |
| Page NOT in nav, still in Google | hidden: true + global seo.indexing: "all" in docs.json | Hidden from nav; still indexed (we use this). |
| Page NOT in nav, NOT in Google | hidden: true (and do not set indexing: "all") | Hidden and not indexed. |
hidden: true→ Mintlify also excludes from search/sitemap unless you setseo.indexing: "all"indocs.json(we do).noindex: true→ Only affects indexing; page stays in nav.
noindex on any page you want discoverable. Use hidden only for pages you want out of the nav but still indexable (with indexing: "all").
What’s configured in this repo
docs.json→seoindexing: "all"– All pages (including hidden) are eligible for indexing and AI context.metatags.canonical:https://docs.ai2fin.com– Canonical base URL to avoid duplicate content.- Title, description, keywords,
og,twitter– Used for all pages unless overridden in frontmatter.
Checklist for new or edited pages
- Default – No frontmatter
noindexorhiddenif you want the page in nav and in Google. - Draft / internal-only – Add
noindex: truein frontmatter so it stays in nav but not in search. - In nav but not in search – Only if you have a strong reason; use
noindex: truein frontmatter. - Optional – Add page-specific
title/descriptionin frontmatter for better snippets.
After deploy
- In Google Search Console for
docs.ai2fin.com: submit sitemap, check “Page indexing” and fix any issues. - Ensure no site-wide noindex in Mintlify Cloud dashboard (if you use it).