`.
+- Las direcciones de correo o los nombres de organización que crees que tienen el vínculo actual, si los conoces.
+- Prueba de que controlas el dominio, como una captura de pantalla del dominio en la consola de administración de tu proveedor de DNS o la capacidad de añadir un registro `TXT` de verificación que el soporte te proporcione.
+
+Una vez que el soporte libere el dominio, vuelve a añadirlo desde tu dashboard o con [`mint add-domain`](/es/cli/commands#mint-add-domain).
+
## Establece una URL canónica
diff --git a/fr/cli/commands.mdx b/fr/cli/commands.mdx
index 177616a8ca..5ceb254977 100644
--- a/fr/cli/commands.mdx
+++ b/fr/cli/commands.mdx
@@ -228,6 +228,8 @@ CNAME @ → cname.mintlify.builders
Ajoutez d'abord les enregistrements `TXT`, puis ajoutez le `CNAME` une fois les enregistrements de vérification validés. Consultez [Domaine personnalisé](/fr/customize/custom-domain) pour les instructions complètes de configuration DNS, les exigences pour les domaines apex et les détails sur le provisionnement TLS.
+Si la commande échoue avec `Domain is already in use by another deployment in your organization` ou `Domain is already claimed by another organization`, le domaine est lié à un autre déploiement Mintlify. Consultez [Domaine déjà revendiqué par une autre organisation](/fr/customize/custom-domain#domain-already-claimed-by-another-organization) pour le libérer et l’ajouter à nouveau.
+
Si certains enregistrements `TXT` sont encore en cours de génération à la fin de la commande, consultez la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard pour récupérer les valeurs restantes.
diff --git a/fr/customize/custom-domain.mdx b/fr/customize/custom-domain.mdx
index 4c66033aa9..a7e6682b50 100644
--- a/fr/customize/custom-domain.mdx
+++ b/fr/customize/custom-domain.mdx
@@ -172,6 +172,46 @@ Ne relancez la validation qu’après avoir vérifié que vos enregistrements DN
Pour supprimer un domaine personnalisé, cliquez sur l’icône de suppression à côté de votre domaine sur la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) et confirmez la suppression. Les liens existants vers ce domaine peuvent cesser de fonctionner, et le réajout du domaine peut nécessiter de reconfigurer vos enregistrements DNS.
+La suppression d’un domaine le libère également afin qu’un autre déploiement ou une autre organisation Mintlify puisse le revendiquer. Consultez [Domaine déjà revendiqué par une autre organisation](#domain-already-claimed-by-another-organization) si vous devez déplacer un domaine entre déploiements.
+
+
+ ## Domaine déjà revendiqué par une autre organisation
+
+
+Lorsque vous ajoutez un domaine déjà enregistré sur un autre déploiement Mintlify, le Dashboard rejette la demande avec l’une des erreurs suivantes :
+
+- `Domain is already in use by another deployment in your organization`. Le domaine est lié à un autre déploiement auquel vous avez accès. Connectez-vous à ce déploiement et supprimez le domaine depuis sa page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain), puis ajoutez-le à nouveau sur le déploiement que vous souhaitez utiliser.
+- `Domain is already claimed by another organization`. Le domaine est lié à un déploiement d’une autre organisation Mintlify. Cela arrive fréquemment avec un compte d’essai ou d’évaluation créé antérieurement, une organisation supprimée ou inutilisée qui conserve le lien, ou un déploiement créé avec une autre adresse e-mail professionnelle.
+
+Un seul déploiement peut détenir un domaine personnalisé à la fois, le déploiement perdant doit donc libérer le domaine avant que le nouveau puisse le revendiquer.
+
+
+ ### Libérer le domaine vous-même
+
+
+Si vous avez encore accès à l’organisation qui détient le domaine :
+
+1. Connectez-vous au [Dashboard](https://app.mintlify.com/) et basculez vers l’organisation qui détient le domaine.
+2. Ouvrez la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) du déploiement perdant.
+3. Cliquez sur l’icône de suppression à côté du domaine et confirmez la suppression.
+4. Pour retirer entièrement le déploiement perdant, supprimez-le depuis la [Danger zone](https://app.mintlify.com/settings/organization/danger-zone). Consultez [Supprimer un déploiement](/fr/deploy/deployments#delete-a-deployment).
+5. Revenez à l’organisation de destination et ajoutez le domaine depuis sa page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain). Vos enregistrements DNS restent valides tant que le `CNAME` pointe toujours vers `cname.mintlify.builders`.
+
+
+ ### Demander une libération au support
+
+
+Si l’organisation perdante est inaccessible, envoyez un e-mail à support@mintlify.com avec une preuve de propriété du domaine afin que Mintlify puisse libérer le lien. Cela s’applique lorsque l’organisation appartient à un ancien employé, qu’elle a été créée avec une adresse e-mail personnelle que vous n’utilisez plus, ou qu’elle a été abandonnée sans être supprimée.
+
+Incluez :
+
+- Le domaine personnalisé, par exemple `docs.example.com`.
+- L’organisation et le déploiement de destination où vous souhaitez ajouter le domaine, au format `app.mintlify.com//`.
+- Les adresses e-mail ou les noms d’organisation dont vous pensez qu’ils détiennent le lien existant, si vous les connaissez.
+- Une preuve que vous contrôlez le domaine, comme une capture d’écran du domaine dans la console d’administration de votre fournisseur DNS ou la possibilité d’ajouter un enregistrement `TXT` de vérification fourni par le support.
+
+Une fois le domaine libéré par le support, ajoutez-le à nouveau depuis votre Dashboard ou avec [`mint add-domain`](/fr/cli/commands#mint-add-domain).
+
## Définir une URL canonique
diff --git a/zh/cli/commands.mdx b/zh/cli/commands.mdx
index 1710670303..b35225bd4d 100644
--- a/zh/cli/commands.mdx
+++ b/zh/cli/commands.mdx
@@ -228,6 +228,8 @@ CNAME @ → cname.mintlify.builders
请先添加 `TXT` 记录，验证记录通过后再添加 `CNAME`。有关完整的 DNS 配置说明、顶级域名要求和 TLS 配置详情，请参见[自定义域名](/zh/customize/custom-domain)。
+如果命令因 `Domain is already in use by another deployment in your organization` 或 `Domain is already claimed by another organization` 而失败，说明该域名已绑定到另一个 Mintlify 部署。请参见[域名已被其他组织占用](/zh/customize/custom-domain#domain-already-claimed-by-another-organization)以释放该域名并重新添加。
+
如果命令结束时某些 `TXT` 记录仍在生成中，请稍后前往控制台的 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面查看剩余的值。
diff --git a/zh/customize/custom-domain.mdx b/zh/customize/custom-domain.mdx
index 749599ef81..d260c32c6b 100644
--- a/zh/customize/custom-domain.mdx
+++ b/zh/customize/custom-domain.mdx
@@ -172,6 +172,46 @@ Mintlify 保留 `/.well-known/acme-challenge` 路径用于证书验证。你不
要移除自定义域名，请在 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面上，点击你的域名旁的 移除图标并确认移除。指向该域名的现有链接可能会失效，重新添加该域名也可能需要重新配置 DNS 记录。
+移除域名也会释放该域名，以便其他 Mintlify 部署或组织可以认领它。如果你需要在部署之间迁移域名，请参见[域名已被其他组织占用](#domain-already-claimed-by-another-organization)。
+
+
+ ## 域名已被其他组织占用
+
+
+当你添加的域名已在另一个 Mintlify 部署上注册时，控制台会拒绝该请求并返回以下错误之一：
+
+- `Domain is already in use by another deployment in your organization`。该域名已绑定到你可访问的另一个部署。请登录该部署，从其 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面移除该域名，然后在你想要使用的部署上重新添加。
+- `Domain is already claimed by another organization`。该域名已绑定到另一个 Mintlify 组织的某个部署。这通常发生在以下情况：早前创建的试用或评估账户、仍持有该绑定的已删除或未使用的组织，或者使用其他工作邮箱创建的部署。
+
+一次只能有一个部署持有某个自定义域名，因此原来的部署必须先释放该域名，新的部署才能认领。
+
+
+ ### 自行释放域名
+
+
+如果你仍然可以访问持有该域名的组织：
+
+1. 登录[控制台](https://app.mintlify.com/)并切换到持有该域名的组织。
+2. 打开原部署的 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面。
+3. 点击域名旁的 移除图标并确认移除。
+4. 要彻底停用原部署，请在 [Danger zone](https://app.mintlify.com/settings/organization/danger-zone) 中删除它。请参见[删除部署](/zh/deploy/deployments#delete-a-deployment)。
+5. 切换回目标组织，并在其 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面添加该域名。只要 `CNAME` 仍指向 `cname.mintlify.builders`，你的 DNS 记录就依然有效。
+
+
+ ### 向支持团队申请释放
+
+
+如果无法访问原组织，请发送邮件至 support@mintlify.com，并提供你对该域名所有权的证明，以便 Mintlify 释放该绑定。此方式适用于以下情况：该组织属于前员工、是使用你不再使用的个人邮箱创建的，或者在删除前已被弃用。
+
+请包含以下信息：
+
+- 自定义域名，例如 `docs.example.com`。
+- 你希望添加该域名的目标组织和部署，格式为 `app.mintlify.com//`。
+- 你认为持有当前绑定的邮箱地址或组织名称（如果知道的话）。
+- 你对该域名拥有控制权的证明，例如域名在你的 DNS 提供商管理控制台中的截图，或者能够添加支持团队提供的验证 `TXT` 记录。
+
+支持团队释放该域名后，请在控制台中重新添加，或使用 [`mint add-domain`](/zh/cli/commands#mint-add-domain) 添加。
+
## 设置规范 URL
From 59c5d2dc24e2b6e8dad65f8679c331490328b912 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Fri, 7 Aug 2026 17:12:33 -0700
Subject: [PATCH 3/4] docs: move domain conflict guidance to help center
---
cli/commands.mdx | 2 +-
customize/custom-domain.mdx | 34 +---------------
docs.json | 3 +-
es/cli/commands.mdx | 2 -
es/customize/custom-domain.mdx | 40 -------------------
fr/cli/commands.mdx | 2 -
fr/customize/custom-domain.mdx | 40 -------------------
...lready-claimed-by-another-organization.mdx | 36 +++++++++++++++++
zh/cli/commands.mdx | 2 -
zh/customize/custom-domain.mdx | 40 -------------------
10 files changed, 40 insertions(+), 161 deletions(-)
create mode 100644 help-center/domain-already-claimed-by-another-organization.mdx
diff --git a/cli/commands.mdx b/cli/commands.mdx
index 3f768dfa84..4ef56a09f9 100644
--- a/cli/commands.mdx
+++ b/cli/commands.mdx
@@ -202,7 +202,7 @@ CNAME @ → cname.mintlify.builders
Add the `TXT` records first, then add the `CNAME` once the verification records validate. See [Custom domain](/customize/custom-domain) for full DNS setup instructions, apex domain requirements, and TLS provisioning details.
-If the command fails with `Domain is already in use by another deployment in your organization` or `Domain is already claimed by another organization`, the domain is bound to another Mintlify deployment. See [Domain already claimed by another organization](/customize/custom-domain#domain-already-claimed-by-another-organization) to release it and re-add.
+If the command fails with `Domain is already in use by another deployment in your organization` or `Domain is already claimed by another organization`, the domain is bound to another Mintlify deployment. See [Add domain fails with "Domain is already claimed by another organization"](/help-center/domain-already-claimed-by-another-organization) to release it and re-add it.
If some `TXT` records are still generating when the command exits, check the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page in your dashboard for the remaining values.
diff --git a/customize/custom-domain.mdx b/customize/custom-domain.mdx
index 3004f1cdf4..92163935da 100644
--- a/customize/custom-domain.mdx
+++ b/customize/custom-domain.mdx
@@ -144,39 +144,7 @@ Only retry validation after you confirm that your DNS records are correct. Repea
To remove a custom domain, click the remove icon next to your domain on the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page and confirm the removal. Existing links to the domain may break, and re-adding the domain may require reconfiguring your DNS records.
-Removing a domain also releases it so that another Mintlify deployment or organization can claim it. See [Domain already claimed by another organization](#domain-already-claimed-by-another-organization) if you need to move a domain between deployments.
-
-## Domain already claimed by another organization
-
-When you add a domain that is already registered on a different Mintlify deployment, the dashboard rejects the request with one of these errors:
-
-- `Domain is already in use by another deployment in your organization`. The domain is bound to another deployment you can access. Sign in to that deployment and remove the domain from its [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page, then re-add it on the deployment you want to use.
-- `Domain is already claimed by another organization`. The domain is bound to a deployment in a different Mintlify organization. This commonly happens with a trial or evaluation account created earlier, a deleted or unused organization that still holds the bind, or a deployment created under a different work email.
-
-Only one deployment can hold a custom domain at a time, so the losing deployment must release the domain before the new one can claim it.
-
-### Release the domain yourself
-
-If you still have access to the organization that holds the domain:
-
-1. Sign in to the [dashboard](https://app.mintlify.com/) and switch to the organization that holds the domain.
-2. Open the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page for the losing deployment.
-3. Click the remove icon next to the domain and confirm removal.
-4. To retire the losing deployment entirely, delete it from the [Danger zone](https://app.mintlify.com/settings/organization/danger-zone). See [Delete a deployment](/deploy/deployments#delete-a-deployment).
-5. Switch back to the destination organization and add the domain from its [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page. Your DNS records stay valid as long as the `CNAME` still points to `cname.mintlify.builders`.
-
-### Request a release from support
-
-If the losing organization is inaccessible, email support@mintlify.com with proof of domain ownership so Mintlify can release the bind. This applies when the organization belongs to a former employee, was created under a personal email you no longer use, or was abandoned before deletion.
-
-Include:
-
-- The custom domain, like `docs.example.com`.
-- The destination organization and deployment where you want to add the domain, formatted as `app.mintlify.com//`.
-- The email addresses or organization names you believe hold the existing bind, if you know them.
-- Proof that you control the domain, such as a screenshot of the domain in your DNS provider's admin console or the ability to add a verification `TXT` record that support gives you.
-
-Once support releases the domain, re-add it from your dashboard or with [`mint add-domain`](/cli/commands#mint-add-domain).
+Removing a domain also releases it so another Mintlify deployment or organization can claim it. If you cannot add a domain because another deployment holds it, see [Add domain fails with "Domain is already claimed by another organization"](/help-center/domain-already-claimed-by-another-organization).
## Set a canonical URL
diff --git a/docs.json b/docs.json
index 3e5903ec13..b6c614efd5 100644
--- a/docs.json
+++ b/docs.json
@@ -459,7 +459,8 @@
{
"group": "Help center",
"pages": [
- "help-center/openapi-url-fetch-fails-during-build"
+ "help-center/openapi-url-fetch-fails-during-build",
+ "help-center/domain-already-claimed-by-another-organization"
]
}
]
diff --git a/es/cli/commands.mdx b/es/cli/commands.mdx
index be5c70bbff..0d705cec6a 100644
--- a/es/cli/commands.mdx
+++ b/es/cli/commands.mdx
@@ -228,8 +228,6 @@ CNAME @ → cname.mintlify.builders
Añade primero los registros `TXT` y, una vez validados, añade el `CNAME`. Consulta [Dominio personalizado](/es/customize/custom-domain) para ver las instrucciones completas de configuración de DNS, los requisitos para dominios apex y los detalles del aprovisionamiento de TLS.
-Si el comando falla con `Domain is already in use by another deployment in your organization` o `Domain is already claimed by another organization`, el dominio está vinculado a otro despliegue de Mintlify. Consulta [Dominio ya reclamado por otra organización](/es/customize/custom-domain#domain-already-claimed-by-another-organization) para liberarlo y volver a añadirlo.
-
Si algunos registros `TXT` aún se están generando cuando el comando finaliza, revisa la página de [Configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/custom-domain) en tu panel para ver los valores restantes.
diff --git a/es/customize/custom-domain.mdx b/es/customize/custom-domain.mdx
index 0b1a2cc6bb..723e68759f 100644
--- a/es/customize/custom-domain.mdx
+++ b/es/customize/custom-domain.mdx
@@ -172,46 +172,6 @@ Reintenta la validación solo después de confirmar que tus registros DNS son co
Para eliminar un dominio personalizado, haz clic en el icono de eliminar junto a tu dominio en la página de [configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/custom-domain) y confirma la eliminación. Los enlaces existentes al dominio pueden romperse y volver a añadir el dominio puede requerir reconfigurar tus registros DNS.
-Eliminar un dominio también lo libera para que otro despliegue u organización de Mintlify pueda reclamarlo. Consulta [Dominio ya reclamado por otra organización](#domain-already-claimed-by-another-organization) si necesitas mover un dominio entre despliegues.
-
-
- ## Dominio ya reclamado por otra organización
-
-
-Cuando añades un dominio que ya está registrado en otro despliegue de Mintlify, el dashboard rechaza la solicitud con uno de estos errores:
-
-- `Domain is already in use by another deployment in your organization`. El dominio está vinculado a otro despliegue al que tienes acceso. Inicia sesión en ese despliegue y elimina el dominio desde su página de [configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/custom-domain), y luego vuelve a añadirlo en el despliegue que quieras usar.
-- `Domain is already claimed by another organization`. El dominio está vinculado a un despliegue en una organización de Mintlify diferente. Esto suele ocurrir con una cuenta de prueba o evaluación creada anteriormente, una organización eliminada o sin uso que aún conserva el vínculo, o un despliegue creado con otro correo de trabajo.
-
-Solo un despliegue puede tener un dominio personalizado a la vez, así que el despliegue que lo pierde debe liberar el dominio antes de que el nuevo pueda reclamarlo.
-
-
- ### Libera el dominio tú mismo
-
-
-Si aún tienes acceso a la organización que posee el dominio:
-
-1. Inicia sesión en el [dashboard](https://app.mintlify.com/) y cambia a la organización que posee el dominio.
-2. Abre la página de [configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/custom-domain) del despliegue que lo pierde.
-3. Haz clic en el icono de eliminar junto al dominio y confirma la eliminación.
-4. Para retirar por completo el despliegue que lo pierde, elimínalo desde la sección [Danger zone](https://app.mintlify.com/settings/organization/danger-zone). Consulta [Eliminar un despliegue](/es/deploy/deployments#delete-a-deployment).
-5. Vuelve a la organización de destino y añade el dominio desde su página de [configuración de dominio personalizado](https://app.mintlify.com/settings/deployment/custom-domain). Tus registros DNS siguen siendo válidos siempre que el `CNAME` continúe apuntando a `cname.mintlify.builders`.
-
-
- ### Solicita una liberación al soporte
-
-
-Si la organización que lo pierde es inaccesible, envía un correo a support@mintlify.com con una prueba de propiedad del dominio para que Mintlify pueda liberar el vínculo. Esto aplica cuando la organización pertenece a un exempleado, se creó con un correo personal que ya no usas, o fue abandonada antes de ser eliminada.
-
-Incluye:
-
-- El dominio personalizado, como `docs.example.com`.
-- La organización y el despliegue de destino donde quieres añadir el dominio, con el formato `app.mintlify.com//`.
-- Las direcciones de correo o los nombres de organización que crees que tienen el vínculo actual, si los conoces.
-- Prueba de que controlas el dominio, como una captura de pantalla del dominio en la consola de administración de tu proveedor de DNS o la capacidad de añadir un registro `TXT` de verificación que el soporte te proporcione.
-
-Una vez que el soporte libere el dominio, vuelve a añadirlo desde tu dashboard o con [`mint add-domain`](/es/cli/commands#mint-add-domain).
-
## Establece una URL canónica
diff --git a/fr/cli/commands.mdx b/fr/cli/commands.mdx
index 5ceb254977..177616a8ca 100644
--- a/fr/cli/commands.mdx
+++ b/fr/cli/commands.mdx
@@ -228,8 +228,6 @@ CNAME @ → cname.mintlify.builders
Ajoutez d'abord les enregistrements `TXT`, puis ajoutez le `CNAME` une fois les enregistrements de vérification validés. Consultez [Domaine personnalisé](/fr/customize/custom-domain) pour les instructions complètes de configuration DNS, les exigences pour les domaines apex et les détails sur le provisionnement TLS.
-Si la commande échoue avec `Domain is already in use by another deployment in your organization` ou `Domain is already claimed by another organization`, le domaine est lié à un autre déploiement Mintlify. Consultez [Domaine déjà revendiqué par une autre organisation](/fr/customize/custom-domain#domain-already-claimed-by-another-organization) pour le libérer et l’ajouter à nouveau.
-
Si certains enregistrements `TXT` sont encore en cours de génération à la fin de la commande, consultez la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard pour récupérer les valeurs restantes.
diff --git a/fr/customize/custom-domain.mdx b/fr/customize/custom-domain.mdx
index a7e6682b50..4c66033aa9 100644
--- a/fr/customize/custom-domain.mdx
+++ b/fr/customize/custom-domain.mdx
@@ -172,46 +172,6 @@ Ne relancez la validation qu’après avoir vérifié que vos enregistrements DN
Pour supprimer un domaine personnalisé, cliquez sur l’icône de suppression à côté de votre domaine sur la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) et confirmez la suppression. Les liens existants vers ce domaine peuvent cesser de fonctionner, et le réajout du domaine peut nécessiter de reconfigurer vos enregistrements DNS.
-La suppression d’un domaine le libère également afin qu’un autre déploiement ou une autre organisation Mintlify puisse le revendiquer. Consultez [Domaine déjà revendiqué par une autre organisation](#domain-already-claimed-by-another-organization) si vous devez déplacer un domaine entre déploiements.
-
-
- ## Domaine déjà revendiqué par une autre organisation
-
-
-Lorsque vous ajoutez un domaine déjà enregistré sur un autre déploiement Mintlify, le Dashboard rejette la demande avec l’une des erreurs suivantes :
-
-- `Domain is already in use by another deployment in your organization`. Le domaine est lié à un autre déploiement auquel vous avez accès. Connectez-vous à ce déploiement et supprimez le domaine depuis sa page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain), puis ajoutez-le à nouveau sur le déploiement que vous souhaitez utiliser.
-- `Domain is already claimed by another organization`. Le domaine est lié à un déploiement d’une autre organisation Mintlify. Cela arrive fréquemment avec un compte d’essai ou d’évaluation créé antérieurement, une organisation supprimée ou inutilisée qui conserve le lien, ou un déploiement créé avec une autre adresse e-mail professionnelle.
-
-Un seul déploiement peut détenir un domaine personnalisé à la fois, le déploiement perdant doit donc libérer le domaine avant que le nouveau puisse le revendiquer.
-
-
- ### Libérer le domaine vous-même
-
-
-Si vous avez encore accès à l’organisation qui détient le domaine :
-
-1. Connectez-vous au [Dashboard](https://app.mintlify.com/) et basculez vers l’organisation qui détient le domaine.
-2. Ouvrez la page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) du déploiement perdant.
-3. Cliquez sur l’icône de suppression à côté du domaine et confirmez la suppression.
-4. Pour retirer entièrement le déploiement perdant, supprimez-le depuis la [Danger zone](https://app.mintlify.com/settings/organization/danger-zone). Consultez [Supprimer un déploiement](/fr/deploy/deployments#delete-a-deployment).
-5. Revenez à l’organisation de destination et ajoutez le domaine depuis sa page [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain). Vos enregistrements DNS restent valides tant que le `CNAME` pointe toujours vers `cname.mintlify.builders`.
-
-
- ### Demander une libération au support
-
-
-Si l’organisation perdante est inaccessible, envoyez un e-mail à support@mintlify.com avec une preuve de propriété du domaine afin que Mintlify puisse libérer le lien. Cela s’applique lorsque l’organisation appartient à un ancien employé, qu’elle a été créée avec une adresse e-mail personnelle que vous n’utilisez plus, ou qu’elle a été abandonnée sans être supprimée.
-
-Incluez :
-
-- Le domaine personnalisé, par exemple `docs.example.com`.
-- L’organisation et le déploiement de destination où vous souhaitez ajouter le domaine, au format `app.mintlify.com//`.
-- Les adresses e-mail ou les noms d’organisation dont vous pensez qu’ils détiennent le lien existant, si vous les connaissez.
-- Une preuve que vous contrôlez le domaine, comme une capture d’écran du domaine dans la console d’administration de votre fournisseur DNS ou la possibilité d’ajouter un enregistrement `TXT` de vérification fourni par le support.
-
-Une fois le domaine libéré par le support, ajoutez-le à nouveau depuis votre Dashboard ou avec [`mint add-domain`](/fr/cli/commands#mint-add-domain).
-
## Définir une URL canonique
diff --git a/help-center/domain-already-claimed-by-another-organization.mdx b/help-center/domain-already-claimed-by-another-organization.mdx
new file mode 100644
index 0000000000..1bcef149fe
--- /dev/null
+++ b/help-center/domain-already-claimed-by-another-organization.mdx
@@ -0,0 +1,36 @@
+---
+title: "Add domain fails with \"Domain is already claimed by another organization\""
+description: "Release a custom domain from another Mintlify deployment or request help when adding it fails because another deployment or organization already holds it."
+keywords: ["Domain is already in use by another deployment in your organization", "Domain is already claimed by another organization", "custom domain", "release domain", "domain ownership"]
+---
+
+When you add a custom domain that is registered on another Mintlify deployment, the dashboard or [`mint add-domain`](/cli/commands#mint-add-domain) returns one of these errors:
+
+- `Domain is already in use by another deployment in your organization` means the domain belongs to another deployment you can access.
+- `Domain is already claimed by another organization` means the domain belongs to a deployment in a different Mintlify organization. This can happen when a trial account, unused organization, or deployment created with another work email still holds the domain.
+
+Only one deployment can hold a custom domain at a time. Release the domain from the current deployment before you add it to the destination deployment.
+
+## Release the domain yourself
+
+If you can access the organization that holds the domain:
+
+1. Sign in to the [dashboard](https://app.mintlify.com/) and switch to the organization that holds the domain.
+2. Open the [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page for the deployment that holds the domain.
+3. Click the remove icon next to the domain and confirm the removal.
+4. Switch to the destination organization and add the domain from its [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) page.
+
+Your DNS records remain valid as long as the `CNAME` still points to `cname.mintlify.builders`. If you also want to retire the old deployment, delete it from the [Danger zone](https://app.mintlify.com/settings/organization/danger-zone). See [Delete a deployment](/deploy/deployments#delete-a-deployment).
+
+## Request a release from support
+
+If you cannot access the organization that holds the domain, email support@mintlify.com with proof that you own it. This can happen when the organization belongs to a former employee, uses a personal email you no longer access, or was abandoned without releasing the domain.
+
+Include:
+
+- The custom domain, like `docs.example.com`.
+- The destination organization and deployment where you want to add it, formatted as `app.mintlify.com//`.
+- Any email addresses or organization names that might hold the domain.
+- Proof that you control the domain, such as a screenshot from your DNS provider's admin console. Support may instead ask you to add a verification `TXT` record.
+
+After support releases the domain, add it from the dashboard or with [`mint add-domain`](/cli/commands#mint-add-domain).
diff --git a/zh/cli/commands.mdx b/zh/cli/commands.mdx
index b35225bd4d..1710670303 100644
--- a/zh/cli/commands.mdx
+++ b/zh/cli/commands.mdx
@@ -228,8 +228,6 @@ CNAME @ → cname.mintlify.builders
请先添加 `TXT` 记录，验证记录通过后再添加 `CNAME`。有关完整的 DNS 配置说明、顶级域名要求和 TLS 配置详情，请参见[自定义域名](/zh/customize/custom-domain)。
-如果命令因 `Domain is already in use by another deployment in your organization` 或 `Domain is already claimed by another organization` 而失败，说明该域名已绑定到另一个 Mintlify 部署。请参见[域名已被其他组织占用](/zh/customize/custom-domain#domain-already-claimed-by-another-organization)以释放该域名并重新添加。
-
如果命令结束时某些 `TXT` 记录仍在生成中，请稍后前往控制台的 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面查看剩余的值。
diff --git a/zh/customize/custom-domain.mdx b/zh/customize/custom-domain.mdx
index d260c32c6b..749599ef81 100644
--- a/zh/customize/custom-domain.mdx
+++ b/zh/customize/custom-domain.mdx
@@ -172,46 +172,6 @@ Mintlify 保留 `/.well-known/acme-challenge` 路径用于证书验证。你不
要移除自定义域名，请在 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面上，点击你的域名旁的 移除图标并确认移除。指向该域名的现有链接可能会失效，重新添加该域名也可能需要重新配置 DNS 记录。
-移除域名也会释放该域名，以便其他 Mintlify 部署或组织可以认领它。如果你需要在部署之间迁移域名，请参见[域名已被其他组织占用](#domain-already-claimed-by-another-organization)。
-
-
- ## 域名已被其他组织占用
-
-
-当你添加的域名已在另一个 Mintlify 部署上注册时，控制台会拒绝该请求并返回以下错误之一：
-
-- `Domain is already in use by another deployment in your organization`。该域名已绑定到你可访问的另一个部署。请登录该部署，从其 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面移除该域名，然后在你想要使用的部署上重新添加。
-- `Domain is already claimed by another organization`。该域名已绑定到另一个 Mintlify 组织的某个部署。这通常发生在以下情况：早前创建的试用或评估账户、仍持有该绑定的已删除或未使用的组织，或者使用其他工作邮箱创建的部署。
-
-一次只能有一个部署持有某个自定义域名，因此原来的部署必须先释放该域名，新的部署才能认领。
-
-
- ### 自行释放域名
-
-
-如果你仍然可以访问持有该域名的组织：
-
-1. 登录[控制台](https://app.mintlify.com/)并切换到持有该域名的组织。
-2. 打开原部署的 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面。
-3. 点击域名旁的 移除图标并确认移除。
-4. 要彻底停用原部署，请在 [Danger zone](https://app.mintlify.com/settings/organization/danger-zone) 中删除它。请参见[删除部署](/zh/deploy/deployments#delete-a-deployment)。
-5. 切换回目标组织，并在其 [Custom domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面添加该域名。只要 `CNAME` 仍指向 `cname.mintlify.builders`，你的 DNS 记录就依然有效。
-
-
- ### 向支持团队申请释放
-
-
-如果无法访问原组织，请发送邮件至 support@mintlify.com，并提供你对该域名所有权的证明，以便 Mintlify 释放该绑定。此方式适用于以下情况：该组织属于前员工、是使用你不再使用的个人邮箱创建的，或者在删除前已被弃用。
-
-请包含以下信息：
-
-- 自定义域名，例如 `docs.example.com`。
-- 你希望添加该域名的目标组织和部署，格式为 `app.mintlify.com//`。
-- 你认为持有当前绑定的邮箱地址或组织名称（如果知道的话）。
-- 你对该域名拥有控制权的证明，例如域名在你的 DNS 提供商管理控制台中的截图，或者能够添加支持团队提供的验证 `TXT` 记录。
-
-支持团队释放该域名后，请在控制台中重新添加，或使用 [`mint add-domain`](/zh/cli/commands#mint-add-domain) 添加。
-
## 设置规范 URL
From a3adf35e5d43446297eb7fda7cda9fb4f011f9d0 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Fri, 7 Aug 2026 17:14:18 -0700
Subject: [PATCH 4/4] Apply suggestion from @ethanpalm
---
help-center/domain-already-claimed-by-another-organization.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/help-center/domain-already-claimed-by-another-organization.mdx b/help-center/domain-already-claimed-by-another-organization.mdx
index 1bcef149fe..29554574ad 100644
--- a/help-center/domain-already-claimed-by-another-organization.mdx
+++ b/help-center/domain-already-claimed-by-another-organization.mdx
@@ -4,7 +4,7 @@ description: "Release a custom domain from another Mintlify deployment or reques
keywords: ["Domain is already in use by another deployment in your organization", "Domain is already claimed by another organization", "custom domain", "release domain", "domain ownership"]
---
-When you add a custom domain that is registered on another Mintlify deployment, the dashboard or [`mint add-domain`](/cli/commands#mint-add-domain) returns one of these errors:
+When you try to add a custom domain that is registered to another Mintlify deployment, the dashboard or [`mint add-domain`](/cli/commands#mint-add-domain) returns one of these errors:
- `Domain is already in use by another deployment in your organization` means the domain belongs to another deployment you can access.
- `Domain is already claimed by another organization` means the domain belongs to a deployment in a different Mintlify organization. This can happen when a trial account, unused organization, or deployment created with another work email still holds the domain.