Skip to content

docs: document custom domain TXT verification records#5678

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/233ace88
Open

docs: document custom domain TXT verification records#5678
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/233ace88

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 6, 2026

Summary

Document the _acme-challenge and _cf-custom-hostname TXT records that the dashboard now displays and automatically verifies when you add a custom domain.

Changes

  • Added a "Verification TXT records" section under "Configure your DNS" explaining the two TXT records, what they're for, and that the dashboard auto-checks their status.
  • Updated TLS provisioning copy to reference Mintlify's automatic certificate flow instead of Vercel.
  • Removed the outdated "Vercel verification" accordion.

Context

The upstream change adds automatic verification of custom-domain TXT records via DNS lookups, and surfaces the records and their configuration status in the dashboard. The existing custom domain page didn't mention these records, so users following the dashboard prompts had no documentation explaining what to add or why.


Note

Low Risk
Low risk documentation-only changes; no product code or runtime behavior is modified.

Overview
Adds a new Verification TXT records section to customize/custom-domain.mdx, documenting the required _acme-challenge and _cf-custom-hostname TXT records and noting the dashboard auto-checks their DNS status.

Updates TLS provisioning wording to reflect Mintlify’s certificate issuance flow (and that HTTPS is available after provisioning), and removes the outdated Vercel-specific verification accordion.

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

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 6, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview May 6, 2026, 6:44 AM

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 800d62f. Configure here.

<Accordion title="Vercel verification">
If Vercel is your domain provider, you must add a verification `TXT` record. This information appears on your dashboard after submitting your custom domain, and is emailed to you.
</Accordion>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Redundant AccordionGroup wrapping a single Accordion element

Low Severity

After removing the "Vercel verification" accordion, the <AccordionGroup> now wraps only a single <Accordion>. In Mintlify, <AccordionGroup> exists to group multiple accordions together; a standalone <Accordion> renders fine on its own without a group wrapper. The <AccordionGroup> is now redundant and adds unnecessary nesting.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 800d62f. Configure here.

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