mintlify · mintlify · Sep 4, 2026 · Sep 4, 2026 · Sep 14, 2026 · Sep 14, 2026
diff --git a/customize/custom-domain.mdx b/customize/custom-domain.mdx
@@ -35,7 +35,7 @@
 
 If your domain traffic routes to Mintlify, the dashboard displays the DNS records to add at your domain provider.
 
-If you proxy only your subpath to Mintlify, the dashboard displays reverse proxy setup guides instead. Follow the guide for your provider and see [Host docs at a subpath](/deploy/docs-subpath) for more information.
+If you proxy only your subpath to Mintlify, follow the reverse proxy guide for your provider instead of adding the `CNAME` record. See [Host docs at a subpath](/deploy/docs-subpath) for more information. If your proxy runs on Cloudflare, the verification `TXT` records shown in your dashboard stay unverified in this setup. This is expected. See [_cf-custom-hostname TXT record stuck unverified](/help-center/cf-custom-hostname-txt-record-stuck-unverified).
 
 <Tip>
   You can also add a domain from the terminal with [`mint add-domain <domain>`](/cli/commands#mint-add-domain). The command registers the domain on your project and prints the DNS records to configure.
@@ -136,7 +136,7 @@
 
 1. Navigate to the [Custom domain setup](https://app.mintlify.com/settings/project/custom-domain) page in your dashboard.
 2. Find your pending custom domain.
-3. Click **Retry validation**.
+3. Click **Re-verify domain**.
 
 Only retry validation after you confirm that your DNS records are correct. Repeated retries with incorrect records do not speed up validation.
 

diff --git a/deploy/docs-subpath.mdx b/deploy/docs-subpath.mdx
@@ -22,6 +22,10 @@
 - [Vercel](/deploy/vercel): Use rewrites to deploy your documentation at your subpath.
 - [Custom reverse proxy](/deploy/reverse-proxy): For other hosting platforms, set up a reverse proxy to deploy your documentation at your subpath.
 
+<Note>
+  When your own proxy serves your subpath, do not add the `CNAME` record shown on the [Custom domain setup](https://app.mintlify.com/settings/project/custom-domain) page. It routes all traffic for the domain to Mintlify and bypasses your proxy. If your proxy runs on Cloudflare, the verification `TXT` records also stay unverified. This is expected and does not affect your documentation. See [_cf-custom-hostname TXT record stuck unverified](/help-center/cf-custom-hostname-txt-record-stuck-unverified).
+</Note>
+
 ### Additional configuration for strict security policies
 
 If you proxy all traffic on your custom domain, you may need to configure your proxy or firewall rules to add the correct [headers](/deploy/csp-configuration). This ensures that your documentation displays properly.
diff --git a/docs.json b/docs.json
@@ -496,7 +496,9 @@
                   "help-center/migrate-from-confluence",
                   "help-center/migrate-docs-from-a-zip-export",
                   "help-center/agent-opens-pull-requests-against-deploy-branch",
-                  "help-center/publish-button-disabled-invalid-mdx"
+                  "help-center/publish-button-disabled-invalid-mdx",
+                  "help-center/host-multiple-docs-sites-on-one-domain",
+                  "help-center/cf-custom-hostname-txt-record-stuck-unverified"
                 ]
               }
             ]

diff --git a/es.json b/es.json
@@ -474,7 +474,9 @@
             "es/help-center/migrate-from-confluence",
             "es/help-center/migrate-docs-from-a-zip-export",
             "es/help-center/agent-opens-pull-requests-against-deploy-branch",
-            "es/help-center/publish-button-disabled-invalid-mdx"
+            "es/help-center/publish-button-disabled-invalid-mdx",
+            "es/help-center/host-multiple-docs-sites-on-one-domain",
+            "es/help-center/cf-custom-hostname-txt-record-stuck-unverified"
           ]
         }
       ]

diff --git a/es/customize/custom-domain.mdx b/es/customize/custom-domain.mdx
@@ -39,7 +39,7 @@ Puedes alojar tu documentación en la raíz de un dominio, en un subdominio o en
 
 Si el tráfico de tu dominio se enruta a Mintlify, el dashboard muestra los registros DNS que debes añadir en tu proveedor de dominio.
 
-Si solo redireccionas tu subruta a Mintlify, el dashboard muestra guías de configuración de proxy inverso en su lugar. Sigue la guía correspondiente a tu proveedor y consulta [Alojar la documentación en una subruta](/es/deploy/docs-subpath) para más información.
+Si solo redireccionas tu subruta a Mintlify, sigue la guía de proxy inverso correspondiente a tu proveedor en lugar de añadir el registro `CNAME`. Consulta [Alojar la documentación en una subruta](/es/deploy/docs-subpath) para más información. Si tu proxy se ejecuta en Cloudflare, los registros `TXT` de verificación que se muestran en tu dashboard permanecen sin verificar en esta configuración. Esto es lo esperado. Consulta [Registro TXT _cf-custom-hostname atascado sin verificar](/es/help-center/cf-custom-hostname-txt-record-stuck-unverified).
 
 <Tip>
   También puedes añadir un dominio desde la terminal con [`mint add-domain <domain>`](/es/cli/commands#mint-add-domain). El comando registra el dominio en tu proyecto e imprime los registros DNS que debes configurar.
@@ -162,7 +162,7 @@ Los registros `TXT` suelen validarse en cinco minutos. Si tu dominio sigue pendi
 
 1. Ve a la página de [configuración de dominio personalizado](https://app.mintlify.com/settings/project/custom-domain) en tu dashboard.
 2. Busca tu dominio personalizado pendiente.
-3. Haz clic en **Retry validation**.
+3. Haz clic en **Re-verify domain**.
 
 Reintenta la validación solo después de confirmar que tus registros DNS son correctos. Los reintentos repetidos con registros incorrectos no aceleran la validación.
 

diff --git a/es/deploy/docs-subpath.mdx b/es/deploy/docs-subpath.mdx
@@ -26,6 +26,10 @@ Si otro sitio se ejecuta en tu dominio, configura tu proveedor de hosting para r
 - [Vercel](/es/deploy/vercel): Usa reescrituras para desplegar tu documentación en tu subruta.
 - [Proxy inverso personalizado](/es/deploy/reverse-proxy): Para otras plataformas de hosting, configura un proxy inverso para desplegar tu documentación en tu subruta.
 
+<Note>
+  Cuando tu propio proxy sirve tu subruta, no añadas el registro `CNAME` que se muestra en la página de [configuración de dominio personalizado](https://app.mintlify.com/settings/project/custom-domain). Este registro enruta todo el tráfico del dominio a Mintlify y omite tu proxy. Si tu proxy se ejecuta en Cloudflare, los registros `TXT` de verificación también permanecen sin verificar. Esto es lo esperado y no afecta a tu documentación. Consulta [Registro TXT _cf-custom-hostname atascado sin verificar](/es/help-center/cf-custom-hostname-txt-record-stuck-unverified).
+</Note>
+
 <div id="additional-configuration-for-strict-security-policies">
   ### Configuración adicional para políticas de seguridad estrictas
 </div>

diff --git a/es/help-center/cf-custom-hostname-txt-record-stuck-unverified.mdx b/es/help-center/cf-custom-hostname-txt-record-stuck-unverified.mdx
@@ -0,0 +1,31 @@
+---
+title: "Registro TXT _cf-custom-hostname atascado sin verificar"
+description: "Por qué los registros TXT de verificación permanecen sin verificar cuando el proxy de tu subruta se ejecuta en Cloudflare, y por qué puedes ignorarlo."
+keywords: ["_cf-custom-hostname", "_acme-challenge", "registro TXT sin verificar", "verificación de dominio atascada", "pending validation", "subruta con proxy", "Cloudflare Worker", "proxy inverso"]
+---
+
+Si alojas tu documentación en una subruta detrás de un proxy inverso que se ejecuta en Cloudflare, como un Cloudflare Worker que reenvía `example.com/docs` a `<your-subdomain>.mintlify.site`, la página de [configuración de dominio personalizado](https://app.mintlify.com/settings/project/custom-domain) sigue mostrando los registros `TXT` de verificación `_cf-custom-hostname` y `_acme-challenge`. En esta configuración, esos registros nunca aparecen como verificados, incluso si los añades en tu proveedor de DNS y haces clic en **Re-verify domain**.
+
+Esto es específico de los proxies que se ejecutan en Cloudflare. Si el proxy de tu subruta se ejecuta en otra plataforma, como Vercel o un proxy inverso nginx personalizado, los registros `TXT` se verifican mediante una consulta DNS estándar y no dependen de hacia dónde se enruta tu tráfico. Si permanecen sin verificar en ese caso, confirma que los añadiste exactamente como se muestran en el proveedor de DNS autoritativo de tu dominio.
+
+<div id="why-the-records-never-verify">
+  ## Por qué los registros nunca se verifican
+</div>
+
+Tu dominio ya pasa por el proxy de Cloudflare, la misma red que usa Mintlify para verificar hostnames personalizados. En esta configuración, Cloudflare no puede completar la verificación de los registros `TXT` solo mediante una consulta DNS. Requiere que el tráfico del hostname se enrute primero a través de su red hasta Mintlify, el mismo requisito descrito en [Dominios detrás del proxy de Cloudflare](/es/customize/custom-domain#cloudflare-proxied-domains).
+
+Cuando tu propio proxy basado en Cloudflare sirve la subruta, el tráfico de tu dominio termina en tu proxy y nunca llega al edge de Mintlify, por lo que tu configuración nunca puede cumplir este requisito. Tu proxy termina TLS con su propio certificado y reenvía las solicitudes a `<your-subdomain>.mintlify.site`, que ya tiene un certificado válido, por lo que los registros permanecen sin verificar indefinidamente.
+
+<div id="what-to-do">
+  ## Qué hacer
+</div>
+
+Nada. El estado sin verificar no afecta a tu documentación. Para confirmar que tu configuración funciona, visita tu subruta, como `example.com/docs`, y comprueba que tu documentación carga mediante HTTPS.
+
+No añadas el registro `CNAME` que se muestra en el dashboard. Enruta todo el tráfico del dominio a Mintlify y omite tu proxy. Aun así necesitas habilitar el interruptor **Host at** y añadir tu dominio con su ruta base en el dashboard para que Mintlify construya tu sitio en la subruta correcta. Consulta [Alojar la documentación en una subruta](/es/deploy/docs-subpath) y la [guía de Cloudflare Workers](/es/deploy/cloudflare).
+
+<div id="when-verification-does-matter">
+  ## Cuándo sí importa la verificación
+</div>
+
+Si el tráfico de tu dominio se enruta a Mintlify a través del `CNAME`, los registros `TXT` deben verificarse antes de que se complete el aprovisionamiento de TLS. Si tu dominio pasa por el proxy de Cloudflare (nube naranja), la verificación solo se completa después de que actualices el `CNAME`. Consulta [Dominios detrás del proxy de Cloudflare](/es/customize/custom-domain#cloudflare-proxied-domains).
diff --git a/es/help-center/host-multiple-docs-sites-on-one-domain.mdx b/es/help-center/host-multiple-docs-sites-on-one-domain.mdx
@@ -0,0 +1,39 @@
+---
+title: "¿Puedo alojar varios sitios de docs en el mismo dominio?"
+description: "Un dominio personalizado se conecta a un proyecto de Mintlify. Combina productos en un sitio con navegación por rutas o usa subdominios."
+keywords: ["varios sitios de documentación", "mismo dominio", "documentación multiproducto", "dominio personalizado", "un proyecto por dominio", "subdominio por producto", "consolidar sitios de documentación"]
+---
+
+Un dominio personalizado se conecta exactamente a un proyecto de Mintlify. No puedes apuntar `example.com/product-a` a un proyecto y `example.com/product-b` a otro. Si intentas añadir un dominio que otro proyecto ya tiene, el dashboard devuelve un error `Domain is already in use by another deployment in your organization` o `Domain is already claimed by another organization`. Consulta [Corregir el error "Domain already claimed by another organization"](/es/help-center/domain-already-claimed-by-another-organization).
+
+Para documentar varios productos, elige uno de estos patrones.
+
+<div id="one-site-with-path-based-navigation">
+  ## Un solo sitio con navegación por rutas
+</div>
+
+Combina todos los productos en un solo proyecto y sepáralos con la navegación. Cada producto obtiene su propia ruta de URL en el dominio compartido, como `docs.example.com/product-a` y `docs.example.com/product-b`.
+
+- Usa [productos](/es/organize/navigation#products), [pestañas](/es/organize/navigation#tabs) o [menús desplegables](/es/organize/navigation#dropdowns) en tu `docs.json` para dar a cada producto una división de navegación dedicada.
+- Si la documentación de cada producto vive en su propio repositorio de Git, usa un [proyecto multi-repositorio](/es/deploy/multi-repo) para combinar los repositorios en un solo sitio con una ruta de URL por repositorio. Los proyectos multi-repositorio están disponibles en los planes Enterprise.
+
+Este patrón mantiene todos los productos buscables desde un solo lugar y requiere un único dominio personalizado.
+
+<div id="separate-sites-on-separate-subdomains">
+  ## Sitios separados en subdominios separados
+</div>
+
+Mantén cada producto como su propio proyecto y asigna a cada proyecto su propio subdominio, como `docs-product-a.example.com` y `docs-product-b.example.com`. Añade cada subdominio como el [dominio personalizado](/es/customize/custom-domain) de su proyecto.
+
+Usa este patrón cuando los productos necesiten sitios totalmente independientes, por ejemplo con equipos, temas o procesos de lanzamiento separados.
+
+<div id="consolidate-existing-sites">
+  ## Consolida sitios existentes
+</div>
+
+Si mueves sitios separados a un solo proyecto:
+
+1. Mueve el contenido al proyecto combinado y organízalo con la navegación.
+2. Añade [redirecciones](/es/create/redirects) en `docs.json` para cualquier ruta de página que haya cambiado. Las redirecciones solo se aplican dentro del proyecto que las define.
+3. Elimina el dominio personalizado de cada proyecto retirado para que el dominio quede liberado. Consulta [Elimina un dominio personalizado](/es/customize/custom-domain#remove-a-custom-domain).
+4. Redirige el tráfico de los subdominios retirados en tu proveedor de DNS o capa de hosting. Mintlify no puede redirigir un dominio que ya no está conectado a un proyecto.
diff --git a/fr.json b/fr.json
@@ -474,7 +474,9 @@
             "fr/help-center/migrate-from-confluence",
             "fr/help-center/migrate-docs-from-a-zip-export",
             "fr/help-center/agent-opens-pull-requests-against-deploy-branch",
-            "fr/help-center/publish-button-disabled-invalid-mdx"
+            "fr/help-center/publish-button-disabled-invalid-mdx",
+            "fr/help-center/host-multiple-docs-sites-on-one-domain",
+            "fr/help-center/cf-custom-hostname-txt-record-stuck-unverified"
           ]
         }
       ]

diff --git a/fr/customize/custom-domain.mdx b/fr/customize/custom-domain.mdx
@@ -39,7 +39,7 @@ Vous pouvez héberger votre documentation à la racine d’un domaine, sur un so
 
 Si le trafic de votre domaine est acheminé vers Mintlify, le Dashboard affiche les enregistrements DNS à ajouter chez votre fournisseur de domaine.
 
-Si vous ne transmettez que votre sous-chemin à Mintlify via un proxy, le Dashboard affiche à la place des guides de configuration de proxy inverse. Suivez le guide correspondant à votre fournisseur et consultez [Héberger la documentation sur un sous-chemin](/fr/deploy/docs-subpath) pour plus d’informations.
+Si vous ne transmettez que votre sous-chemin à Mintlify via un proxy, suivez le guide de proxy inverse correspondant à votre fournisseur au lieu d’ajouter l’enregistrement `CNAME`. Consultez [Héberger la documentation sur un sous-chemin](/fr/deploy/docs-subpath) pour plus d’informations. Si votre proxy s’exécute sur Cloudflare, les enregistrements `TXT` de vérification affichés dans votre Dashboard restent non vérifiés dans cette configuration. C’est un comportement attendu. Consultez [Enregistrement TXT _cf-custom-hostname non vérifié](/fr/help-center/cf-custom-hostname-txt-record-stuck-unverified).
 
 <Tip>
   Vous pouvez également ajouter un domaine depuis le terminal avec [`mint add-domain <domain>`](/fr/cli/commands#mint-add-domain). La commande enregistre le domaine sur votre projet et affiche les enregistrements DNS à configurer.
@@ -162,7 +162,7 @@ Les enregistrements `TXT` sont généralement validés en cinq minutes. Si votre
 
 1. Accédez à la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/project/custom-domain) dans votre Dashboard.
 2. Repérez votre domaine personnalisé en attente.
-3. Cliquez sur **Retry validation**.
+3. Cliquez sur **Re-verify domain**.
 
 Ne relancez la validation qu’après avoir vérifié que vos enregistrements DNS sont corrects. Des relances répétées avec des enregistrements incorrects n’accélèrent pas la validation.
 

diff --git a/fr/deploy/docs-subpath.mdx b/fr/deploy/docs-subpath.mdx
@@ -26,6 +26,10 @@ Si un autre site fonctionne sur votre domaine, configurez votre fournisseur d’
 - [Vercel](/fr/deploy/vercel) : utilisez des réécritures pour déployer votre documentation à votre sous-chemin.
 - [Proxy inverse personnalisé](/fr/deploy/reverse-proxy) : pour d’autres plateformes d’hébergement, configurez un proxy inverse pour déployer votre documentation à votre sous-chemin.
 
+<Note>
+  Lorsque votre propre proxy sert votre sous-chemin, n’ajoutez pas l’enregistrement `CNAME` affiché sur la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/project/custom-domain). Il achemine tout le trafic du domaine vers Mintlify et contourne votre proxy. Si votre proxy s’exécute sur Cloudflare, les enregistrements `TXT` de vérification restent également non vérifiés. C’est un comportement attendu et cela n’affecte pas votre documentation. Consultez [Enregistrement TXT _cf-custom-hostname non vérifié](/fr/help-center/cf-custom-hostname-txt-record-stuck-unverified).
+</Note>
+
 <div id="additional-configuration-for-strict-security-policies">
   ### Configuration supplémentaire pour des stratégies de sécurité strictes
 </div>