mintlify · mintlify · Sep 4, 2026 · Sep 4, 2026
diff --git a/customize/custom-domain.mdx b/customize/custom-domain.mdx
@@ -16,6 +16,8 @@
 
 You can host your documentation at the root of a domain, a subdomain, or a subpath.
 
+A custom domain connects to exactly one deployment. To document multiple products on one domain, combine them into a single site with path-based navigation or give each product its own subdomain. See [Can I host multiple docs sites on the same domain?](/help-center/host-multiple-docs-sites-on-one-domain).
+
 **Domain or subdomain**: Host your documentation at a domain like `example.com` or a subdomain like `docs.example.com`. Mintlify serves all traffic for the domain or subdomain. Hosting at a domain with no subdomain requires a DNS provider that supports CNAME flattening or `ALIAS` records. See [Apex domains](#apex-domains).
 
 **Subpath**: Host your documentation at a path on your domain, like `example.com/docs`. Enable the **Host at** toggle when you add your domain and enter your base path. How traffic reaches Mintlify depends on your DNS:
@@ -35,7 +37,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. 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 deployment and prints the DNS records to configure.

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 DNS records shown on the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page. The verification `TXT` records stay unverified because traffic for your domain never routes to Mintlify. 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
@@ -481,7 +481,9 @@
                   "help-center/preview-deployment-not-created-for-fork-branch",
                   "help-center/branch-missing-from-editor-branch-list",
                   "help-center/style-card-icons-with-custom-css",
-                  "help-center/can-i-rename-my-deployment-or-organization"
+                  "help-center/can-i-rename-my-deployment-or-organization",
+                  "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
@@ -459,7 +459,9 @@
             "es/help-center/preview-deployment-not-created-for-fork-branch",
             "es/help-center/branch-missing-from-editor-branch-list",
             "es/help-center/style-card-icons-with-custom-css",
-            "es/help-center/can-i-rename-my-deployment-or-organization"
+            "es/help-center/can-i-rename-my-deployment-or-organization",
+            "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
@@ -18,6 +18,8 @@ Para alojar tu documentación en un dominio personalizado:
 
 Puedes alojar tu documentación en la raíz de un dominio, en un subdominio o en una subruta.
 
+Un dominio personalizado se conecta exactamente a una implementación. Para documentar varios productos en un dominio, combínalos en un solo sitio con navegación por rutas o asigna a cada producto su propio subdominio. Consulta [¿Puedo alojar varios sitios de docs en el mismo dominio?](/es/help-center/host-multiple-docs-sites-on-one-domain).
+
 **Dominio o subdominio**: Aloja tu documentación en un dominio como `example.com` o en un subdominio como `docs.example.com`. Mintlify sirve todo el tráfico del dominio o subdominio. Alojar en un dominio sin subdominio requiere un proveedor de DNS que admita el aplanamiento de CNAME o registros `ALIAS`. Consulta [Dominios apex](#apex-domains).
 
 **Subruta**: Aloja tu documentación en una ruta dentro de tu dominio, como `example.com/docs`. Habilita el interruptor **Host at** al añadir tu dominio e ingresa tu ruta base. Cómo llega el tráfico a Mintlify depende de tu DNS:
@@ -39,7 +41,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. 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 implementación e imprime los registros DNS que debes configurar.

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 los registros DNS que se muestran en la página de [configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/custom-domain). Los registros `TXT` de verificación permanecen sin verificar porque el tráfico de tu dominio nunca se enruta a Mintlify. 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,29 @@
+---
+title: "Registro TXT _cf-custom-hostname atascado sin verificar"
+description: "Por qué los registros TXT de verificación permanecen sin verificar cuando tu propio proxy inverso sirve tu subruta 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 tu propio proxy inverso, como un Cloudflare Worker que reenvía `example.com/docs` a `<your-subdomain>.mintlifysite.com`, la página de [configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/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 **Retry validation**.
+
+<div id="why-the-records-never-verify">
+  ## Por qué los registros nunca se verifican
+</div>
+
+Los registros `TXT` de verificación solo se aplican cuando el tráfico de tu dominio se enruta a Mintlify a través de un registro `CNAME` que apunta a `cname.mintlify.builders`. Verifican que controlas el dominio y autorizan a Let's Encrypt a emitir un certificado TLS que Mintlify sirve.
+
+Cuando tu propio proxy sirve la subruta, el tráfico de tu dominio nunca llega al edge de Mintlify. Tu proxy termina TLS con tu propio certificado y reenvía las solicitudes a `<your-subdomain>.mintlifysite.com`, que ya tiene un certificado válido. Mintlify no tiene nada que verificar ni aprovisionar para tu dominio, 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 una implementación 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", "una implementación por dominio", "subdominio por producto", "consolidar sitios de documentación"]
+---
+
+Un dominio personalizado se conecta exactamente a una implementación de Mintlify. No puedes apuntar `example.com/product-a` a una implementación y `example.com/product-b` a otra. Si intentas añadir un dominio que otra implementación 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 una sola implementación 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 una [implementación multirepositorio](/es/deploy/multi-repo) para combinar los repositorios en un solo sitio con una ruta de URL por repositorio. Las implementaciones multirepositorio 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 propia implementación y asigna a cada implementación 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 implementación.
+
+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 una sola implementación:
+
+1. Mueve el contenido a la implementación combinada 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 de la implementación que las define.
+3. Elimina el dominio personalizado de cada implementación retirada 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 una implementación.
diff --git a/fr.json b/fr.json
@@ -459,7 +459,9 @@
             "fr/help-center/preview-deployment-not-created-for-fork-branch",
             "fr/help-center/branch-missing-from-editor-branch-list",
             "fr/help-center/style-card-icons-with-custom-css",
-            "fr/help-center/can-i-rename-my-deployment-or-organization"
+            "fr/help-center/can-i-rename-my-deployment-or-organization",
+            "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
@@ -18,6 +18,8 @@ Pour héberger votre documentation sur un domaine personnalisé :
 
 Vous pouvez héberger votre documentation à la racine d’un domaine, sur un sous-domaine ou sur un sous-chemin.
 
+Un domaine personnalisé se connecte à exactement un déploiement. Pour documenter plusieurs produits sur un même domaine, combinez-les en un seul site avec une navigation par chemins ou donnez à chaque produit son propre sous-domaine. Consultez [Puis-je héberger plusieurs sites de documentation sur le même domaine ?](/fr/help-center/host-multiple-docs-sites-on-one-domain).
+
 **Domaine ou sous-domaine** : hébergez votre documentation sur un domaine comme `example.com` ou un sous-domaine comme `docs.example.com`. Mintlify sert l’ensemble du trafic du domaine ou du sous-domaine. L’hébergement sur un domaine sans sous-domaine nécessite un fournisseur DNS qui prend en charge le CNAME flattening ou les enregistrements `ALIAS`. Consultez [Apex domains](#apex-domains).
 
 **Sous-chemin** : hébergez votre documentation sur un chemin de votre domaine, comme `example.com/docs`. Activez le bouton **Host at** lorsque vous ajoutez votre domaine et saisissez votre chemin de base. La façon dont le trafic atteint Mintlify dépend de votre DNS :
@@ -39,7 +41,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. 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 déploiement et affiche les enregistrements DNS à configurer.

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 les enregistrements DNS affichés sur la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain). Les enregistrements `TXT` de vérification restent non vérifiés car le trafic de votre domaine n’est jamais acheminé vers Mintlify. 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>