Update from code changes: switch hosted docs domain to mintlify.site#6296
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Updates 45 files that PR 6282 had originally changed but were reverted by PR 6285 and not re-addressed in this PR: - snippets/vercel-json-generator.mdx (all 4 locales): rewrite destinations now use mintlify.site, consistent with deploy/vercel.mdx - assistant/use.mdx: example deep-link URLs - ai/skillmd.mdx: agent card subdomain reference - guides/assistant-embed.mdx: docsURL code example - guides/codex.mdx: MCP URL example - deploy/authentication-setup.mdx: example Mintlify subdomain - discovery-openapi.json: domain identifier URL descriptions (4 occurrences) - integrations/privacy/osano.mdx: managed rule domain - editor/branching-and-publishing.mdx: branch preview URL format - customize/themes.mdx: theme demo site links - guides/help-center.mdx: live example link - zh/editor/collaborate.mdx: branch preview URL format All changes mirrored across es, fr, and zh locales. Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
2 participants
Summary
Default Mintlify-hosted docs URLs are now unified to
mintlify.siteacross every base path. Updated the deployment guides, CSP allowlist, and quickstart references so customer proxy/CDN configurations and onboarding content reflect the new canonical hostname.Changes
Host at /docsand custom subpath targets to<your-subdomain>.mintlify.site, removed the obsoletemintlify.devvsmintlify.appcache invalidation distinction, and updated routing tables, NGINX examples, and troubleshooting steps.[SUBDOMAIN].mintlify.site.[subdomain].mintlify.site.*.mintlify.devwith*.mintlify.sitein the allowlist table and example policies..mintlify.site.es,fr, andzhlocales.Context
Mintlify's hosted display domain has been unified to
mintlify.siteinstead of per-base-path hosts (mintlify.dev,mintlify.app, etc.). Documentation that points customers at proxy targets, CSP allowlists, or default URLs needed to match the new canonical hostname.Note
Low Risk
Documentation-only hostname updates with no application code changes; incorrect copy could mislead customers configuring proxies or CSP until they follow the new guidance.
Overview
Documentation now treats
mintlify.siteas the canonical Mintlify-hosted docs hostname, replacing references tomintlify.appandmintlify.devacross English and localized (es,fr,zh) content.Deployment and proxy guides (reverse proxy, Vercel rewrites, Cloudflare Workers, Route 53/CloudFront) point all proxy origins and rewrite destinations at
<subdomain>.mintlify.site. The reverse-proxy page no longer splits targets by subpath (devvsapp); both Host at/docsand custom subpath setups use the same hostname, with updated canonical URL and troubleshooting wording.CSP allowlists and sample policies swap
*.mintlify.devfor*.mintlify.siteinconnect-srcandframe-src. Onboarding and product copy (quickstart, what-is-Mintlify, auth eligibility examples, editor preview URLs, theme demo links, OpenAPI domain descriptions, Osano allowlist, assistant/MCP/guide snippets, and Vercel JSON generator snippets) use.mintlify.sitefor default and example URLs.Reviewed by Cursor Bugbot for commit e5c9488. Bugbot is set up for automated code reviews on this repo. Configure here.