Custom domain setup

Point a custom domain to your Mintlify docs site.

A custom domain makes your docs feel like a native part of your product — for example, docs.yourcompany.com instead of yourcompany.mintlify.app.

Custom domains are available on Growth and Enterprise plans.

Steps

1. Add your domain in Mintlify

   Open your project in the Mintlify dashboard and go to Settings → Custom domain. Enter the domain you want to use (for example, docs.yourcompany.com) and click Save.

   Mintlify will show you the DNS record you need to add.

2. Add a CNAME record in your DNS provider

   In your DNS provider’s settings, create a CNAME record:

   Type	Name	Value
   CNAME	docs	hosting.mintlify.com

   If you want to use a root domain (for example, yourcompany.com), use an ALIAS or ANAME record instead — standard CNAME records don’t support root domains.

3. Wait for DNS to propagate

   DNS changes can take a few minutes to a few hours to propagate. Mintlify checks your DNS automatically and provisions an SSL certificate once it can verify the domain.

SSL

Mintlify provisions a free TLS certificate (via Let’s Encrypt) for your custom domain automatically. You don’t need to manage certificates manually.

Troubleshooting

The domain shows as “pending” after several hours. Run dig docs.yourcompany.com CNAME to verify the CNAME is pointing to hosting.mintlify.com. If not, double-check the DNS record and try again. Some DNS providers cache records aggressively — flush the cache if available.

I’m getting an SSL error. SSL provisioning happens after DNS propagates. Wait a few hours after the DNS check passes. If it still fails after 24 hours, contact support.