Skip to main content
To host your documentation on a custom domain, set your desired custom domain in your Mintlify settings and configure your DNS settings on your domain provider.
Looking to set up a custom subdirectory like mintlify.com/docs? See the custom subdirectory docs.

​
Dashboard settings

  1. Navigate to your dashboard.
  2. Select Settings.
  3. Select Domain Setup.
  4. Enter your desired custom domain. For example, docs.mintlify.com.
The Custom Domain setup page with the Enter your domain URL field highlighted.

​
Configure your DNS

  1. Navigate to your domain’s DNS settings on your domain provider’s website.
  2. Create a new DNS entry with the following values:
CNAME | docs | cname.vercel-dns.com.
Sample CNAME settings for a custom domain hosted on Vercel.

​
Provider-specific settings

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.
If Cloudflare is your DNS provider, you must enable the “full strict” security option for the HTTPS setting.

​
Set a canonical URL

After configuring your DNS, set a canonical URL to ensure search engines index your preferred domain. A canonical URL tells search engines which version of your documentation is the primary one. This improves SEO when your documentation is accessible from multiple URLs and prevents issues with duplicate content. Add the canonical meta tag to your docs.json: 
"seo": {
    "metatags": {
        "canonical": "https://www.your-custom-domain-here.com"
    }
}
Replace https://www.your-custom-domain-here.com with your actual custom domain. For example, if your custom domain is docs.mintlify.com, you would use: 
"seo": {
    "metatags": {
        "canonical": "https://docs.mintlify.com"
    }
}
⌘I