From d475301444e1315982c543488519f4dad554094a Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Mon, 7 Jul 2025 16:01:23 -0700 Subject: [PATCH 1/2] add provider-specific settings section --- settings/custom-domain.mdx | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/settings/custom-domain.mdx b/settings/custom-domain.mdx index 48a1f8581..963c7005a 100644 --- a/settings/custom-domain.mdx +++ b/settings/custom-domain.mdx @@ -7,16 +7,15 @@ icon: "globe" To set up your documentation on a custom domain, you'll need to 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? Find - instructions [here](/advanced/subpath/cloudflare). + Looking to set up a custom subdirectory like `mintlify.com/docs`? See the [custom subdirectory](/advanced/subpath/cloudflare) docs. -## Dashboard Settings +## Dashboard settings -1. Head over to the [dashboard](https://dashboard.mintlify.com) -2. Click on "Settings". -3. Click on "Custom Domain". -4. Enter your desired custom domain. For example, `docs.mintlify.com`. +1. Navigate to your [dashboard](https://dashboard.mintlify.com) +2. Select **Settings** +3. Select **Domain Setup** +4. Enter your desired custom domain. For example, `docs.mintlify.com` -## Verification with Vercel - -If Vercel happens to be your domain provider, you will have to add a verification `TXT` record. This information will show on your dashboard after submitting your custom domain, as well as be emailed to you. - ## Configuring your DNS 1. Proceed to your domain's DNS settings on your domain provider's website. @@ -48,6 +43,12 @@ CNAME | docs | cname.vercel-dns.com. DNS -If you are using Cloudflare for your DNS provider, you'll need to have the “full strict” security option enabled for the https setting. +## Provider-specific settings + +### Vercel verification + +If Vercel is your domain provider, you must add a verification `TXT` record. This information will show on your dashboard after submitting your custom domain, as well as be emailed to you. + +### Cloudflare security settings -Please [contact support](mailto:support@mintlify.com) if you don't see the custom domain set up after the above configuration. +If Cloudflare is your DNS provider, you must enable the "full strict" security option for the https setting. From 5430d16f1ea5dd10a471dbc1610a7b077b9ca5e6 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Mon, 7 Jul 2025 16:26:52 -0700 Subject: [PATCH 2/2] use accordions --- settings/custom-domain.mdx | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/settings/custom-domain.mdx b/settings/custom-domain.mdx index 963c7005a..a023398ee 100644 --- a/settings/custom-domain.mdx +++ b/settings/custom-domain.mdx @@ -45,10 +45,12 @@ CNAME | docs | cname.vercel-dns.com. ## Provider-specific settings -### Vercel verification - -If Vercel is your domain provider, you must add a verification `TXT` record. This information will show on your dashboard after submitting your custom domain, as well as be emailed to you. - -### Cloudflare security settings - -If Cloudflare is your DNS provider, you must enable the "full strict" security option for the https setting. + + + If Vercel is your domain provider, you must add a verification `TXT` record. This information will show on your dashboard after submitting your custom domain, as well as be emailed to you. + + + + If Cloudflare is your DNS provider, you must enable the "full strict" security option for the https setting. + + \ No newline at end of file