From 903ebee08df431a9a70c0c318768c7ea43ed3305 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Fri, 17 Jul 2026 00:18:41 +0000 Subject: [PATCH] docs: document apex domain A and AAAA records for custom domains --- customize/custom-domain.mdx | 30 ++++++++++++++++++++++++++++-- 1 file changed, 28 insertions(+), 2 deletions(-) diff --git a/customize/custom-domain.mdx b/customize/custom-domain.mdx index 162a045c6a..8e75f1f499 100644 --- a/customize/custom-domain.mdx +++ b/customize/custom-domain.mdx @@ -80,9 +80,35 @@ The dashboard polls DNS in the background and marks each record with a green che ### Apex domains -If you host your documentation at an apex domain like `example.com` with no subdomain, your DNS provider must support CNAME flattening or a virtual record type like `ALIAS` or `ANAME`. Standard DNS does not allow a `CNAME` record at the apex of a domain, so providers without this support cannot create the record shown in your dashboard. +If you host your documentation at an apex domain like `example.com` with no subdomain, you have two options: -Providers that support apex `CNAME` records include Cloudflare (CNAME flattening), Amazon Route 53 (alias records), DNSimple (`ALIAS` records), and Porkbun (`ALIAS` records). If your provider does not support any of these, host your documentation at a subdomain like `docs.example.com` instead. +- Use CNAME flattening or a virtual record type like `ALIAS` or `ANAME` on providers that support it. +- Use `A` and `AAAA` records that point directly to Mintlify's edge. + +Standard DNS does not allow a `CNAME` record at the apex of a domain, so providers without flattening or `ALIAS`/`ANAME` support cannot create the record shown in your dashboard. + +#### CNAME flattening or ALIAS records + +Providers that support apex `CNAME` records include Cloudflare (CNAME flattening), Amazon Route 53 (alias records), DNSimple (`ALIAS` records), and Porkbun (`ALIAS` records). On these providers, create the record shown in your dashboard as-is and the provider resolves it to Mintlify's edge automatically. + +#### A and AAAA records + +If your provider does not support CNAME flattening or `ALIAS`/`ANAME` records, point your apex domain at Mintlify's edge with the following `A` and `AAAA` records instead of the `CNAME` shown in your dashboard: + +```text +A | | 162.159.143.13 +A | | 172.66.3.9 +AAAA | | 2606:4700:7::2fd +AAAA | | 2a06:98c1:58::2fd +``` + +Add all four records. Keep the verification `TXT` records from your dashboard in place — they are still required for domain verification and TLS certificate issuance. + + + The `CNAME` and `A`/`AAAA` approaches are mutually exclusive. If you use the `A` and `AAAA` records above, do not also create a `CNAME` for the same hostname. + + +If you would rather not manage apex records, host your documentation at a subdomain like `docs.example.com` and redirect the apex to it at your DNS provider or CDN. ### DNS propagation