Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,19 @@
Each domain provider has different ways to add DNS records. Refer to your domain provider's documentation for specific instructions.
</Tip>

<Note>
Some DNS providers, such as Namecheap and GoDaddy, automatically append your apex domain to whatever you enter in the **Name** field. If your provider does this, omit the apex domain suffix when pasting each record so it isn't duplicated.

Check warning on line 49 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L49

Did you really mean 'Namecheap'?

For example, if your dashboard shows a record name like `_cf-custom-hostname.docs.example.com` and your domain is `example.com`, paste `_cf-custom-hostname.docs` instead of the full value. Providers like Cloudflare, Route 53, and DNSimple accept the fully-qualified value as shown.

Check warning on line 51 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L51

Did you really mean 'DNSimple'?

Check warning on line 51 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L51

'fully-qualified' doesn't need a hyphen.
</Note>

<Warning>
If you migrate an existing domain and want zero downtime, add the verification `TXT` records before updating your `CNAME`. Then wait until SSL/TLS certificates pre-provision before cutting over. Switching the `CNAME` before certificates are issued causes HTTPS requests to fail until provisioning completes.

Check warning on line 55 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L55

In general, use active voice instead of passive voice ('are issued').
</Warning>

### DNS propagation

DNS changes typically take 1-24 hours to propagate globally, though it can take up to 48 hours in some cases. You can verify your DNS is configured correctly using [DNSChecker](https://dnschecker.org).

Check warning on line 60 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L60

In general, use active voice instead of passive voice ('is configured').

Once your DNS records are active, your documentation is first accessible via HTTP. HTTPS is available after Vercel provisions your TLS certificate.

Expand All @@ -71,13 +77,13 @@

### Reserved paths

The `/.well-known/acme-challenge` path is reserved for certificate validation and cannot be redirected or rewritten. If you have configured redirects or rewrites for this path, certificate provisioning fails.

Check warning on line 80 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L80

In general, use active voice instead of passive voice ('is reserved').

Check warning on line 80 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L80

In general, use active voice instead of passive voice ('be redirected').

### Provider-specific settings

<AccordionGroup>
<Accordion title="Vercel verification">
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.

Check warning on line 86 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L86

In general, use active voice instead of passive voice ('is emailed').
</Accordion>

<Accordion title="Cloudflare encryption mode">
Expand Down
6 changes: 6 additions & 0 deletions es/customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,12 @@ CNAME | docs | cname.mintlify.builders
Cada proveedor de dominios tiene diferentes formas de agregar registros DNS. Consulta la documentación de tu proveedor de dominios para obtener instrucciones específicas.
</Tip>

<Note>
Algunos proveedores de DNS, como Namecheap y GoDaddy, añaden automáticamente tu dominio apex a lo que ingreses en el campo **Name**. Si tu proveedor hace esto, omite el sufijo del dominio apex al pegar cada registro para que no se duplique.

Por ejemplo, si tu dashboard muestra un nombre de registro como `_cf-custom-hostname.docs.example.com` y tu dominio es `example.com`, pega `_cf-custom-hostname.docs` en lugar del valor completo. Proveedores como Cloudflare, Route 53 y DNSimple aceptan el valor totalmente calificado tal como se muestra.
</Note>

<Warning>
Si estás migrando un dominio existente y quieres cero tiempo de inactividad, agrega los registros `TXT` de verificación antes de actualizar tu `CNAME` y espera a que los certificados SSL/TLS estén pre-provisionados antes de hacer el cambio. Cambiar el `CNAME` antes de que se emitan los certificados provoca que las solicitudes HTTPS fallen hasta que se complete el aprovisionamiento.
</Warning>
Expand Down
Loading