> ## Documentation Index
> Fetch the complete documentation index at: https://help-center-starter-replace-template-content.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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](mailto:support@mintlify.com).