Update from support feedback: custom domain day-2 operations

[mintlify-development]

Summary

Adds a "Manage an existing custom domain" section to the custom domain page covering post-setup operations that support has been repeatedly asked about.

Changes

• Document how to change or replace an existing custom domain, including zero-downtime handoff.
• Clarify that _acme-challenge and _cf-custom-hostname TXT values can be regenerated by the dashboard and that users must always paste the currently displayed values.
• Add guidance for serving documentation across multiple domains: redirect-only, Enterprise multi-repository deployments, and external reverse-proxy patterns, with links to the existing Cloudflare, Vercel, and reverse-proxy pages.
• Document how to release/decommission a custom domain and clean up DNS records.

Context

Recurring resolved support conversations show that /customize/custom-domain covers first-time setup well but does not address day-2 operations (swap domain, re-verification when TXT values change, multi-domain/subpath serving, decommissioning).

---

Note

Low Risk
Documentation-only change with no application, auth, or deployment code impact.

Overview
Adds a Manage an existing custom domain section to customize/custom-domain.mdx for post-setup operations that support sees often, placed before Set a canonical URL.

It documents changing or replacing a primary domain (remove, add new, DNS cleanup, optional zero-downtime handoff and redirects) and notes the one primary custom domain per project limit with a pointer to multi-hostname options.

Re-verify when TXT values change explains when _acme-challenge and _cf-custom-hostname values can be regenerated and instructs users to use only the values currently shown in the dashboard, with steps to replace stale DNS records and recover after remove/re-add.

Serve documentation across multiple domains covers 301 redirects to the primary domain, Enterprise multi-repository deployments, and external reverse-proxy patterns with links to Cloudflare, Vercel, and custom reverse-proxy docs.

Release a custom domain covers dashboard removal, DNS cleanup, and that Mintlify stops serving and renewing TLS for that hostname.

^{Reviewed by Cursor Bugbot for commit 38764ea. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Jul 8, 2026, 3:10 AM

[mintlify]

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

Project	Status	Preview	Updated (UTC)
tomee	🟢 Ready	View Preview	Jul 8, 2026, 3:05 AM

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