Skip to content

Update from support feedback: apex domain A/AAAA records#6628

Open
mintlify-development[bot] wants to merge 1 commit into
mainfrom
mintlify/4cfc2cd8
Open

Update from support feedback: apex domain A/AAAA records#6628
mintlify-development[bot] wants to merge 1 commit into
mainfrom
mintlify/4cfc2cd8

Conversation

@mintlify-development

@mintlify-development mintlify-development Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Summary

Multiple customers on zone-apex domains (e.g. example.com) have asked support how to point their apex at Mintlify since CNAME is not legal at the apex on most providers. Support has been handing out a specific set of A and AAAA records to unblock them; this documents that path in customize/custom-domain so users can self-serve.

Changes

  • Split the Apex domains section into two options: CNAME flattening / ALIAS records and direct A / AAAA records.
  • Added the supported A (162.159.143.13, 172.66.3.9) and AAAA (2606:4700:7::2fd, 2a06:98c1:58::2fd) values with a note that TXT verification records are still required and that the CNAME and A/AAAA approaches are mutually exclusive.

Support context


Note

Low Risk
Documentation-only change to custom-domain setup guidance; no application or infrastructure code.

Overview
Documents a self-serve path for zone-apex custom domains when DNS providers cannot use apex CNAME / flattening / ALIAS—a flow support was already sharing manually.

The Apex domains section is restructured into two paths: CNAME flattening or ALIAS/ANAME (unchanged intent, clearer wording) and a new A and AAAA subsection with four edge IPs (162.159.143.13, 172.66.3.9, and two IPv6 targets). It states that dashboard TXT verification records stay required, that CNAME and A/AAAA must not be mixed for the same hostname, and still points users without apex options to a subdomain like docs.example.com.

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

@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Jul 17, 2026, 12:21 AM

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Jul 17, 2026, 12:21 AM

💡 Tip: Enable Workflows 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.

1 participant