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
28 changes: 28 additions & 0 deletions customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -118,6 +118,34 @@

Only retry validation after you confirm that your DNS records are correct. Repeated retries with incorrect records do not speed up validation.

## Managing a custom domain

### Default subdomain remains active

Your deployment's default `<subdomain>.mintlify.site` URL cannot be disabled or redirected today, even after a custom domain is live. Both URLs serve the same content. Set a [canonical URL](#set-a-canonical-url) so search engines index the custom domain as the primary one.

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

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L125

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

### Renaming a project

Renaming a project in your dashboard changes only the display name. It does not change the deployment URL or the default `<subdomain>.mintlify.site` hostname.

If you rename a project and then see a `Disallowed origin host` error at your default URL, the deployment's hostname no longer matches what your dashboard expects. To change the URL, delete the deployment and recreate it with the desired name. There is no in-place rename for the deployment URL.

### Releasing a domain

A custom domain can only be attached to one Mintlify deployment at a time. If your domain is still attached to a previous deployment or organization (for example, after moving to a new workspace), the new deployment cannot claim it until the old one releases it.

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

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L135

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

To release a domain you control:

1. Contact [support](mailto:support@mintlify.com) and request release of the domain.
2. Support provides a verification `TXT` record with a unique value.
3. Add the record at your DNS provider:

```text
TXT | <your-domain> | <value provided by support>
```

4. Reply to support once the record is live. Support verifies the record and detaches the domain from the previous deployment. You can then add it to your new deployment following [Add your custom domain](#add-your-custom-domain).

## Set a canonical URL

After configuring your DNS, set a canonical URL to ensure search engines index your preferred domain. A canonical URL tells search engines which version of your documentation is the primary one. This improves SEO when your documentation is accessible from multiple URLs and prevents issues with duplicate content.
Expand Down
36 changes: 36 additions & 0 deletions es/customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,42 @@ Después de añadir un registro `TXT` de verificación, la validación del domin

Usa esta opción solo después de confirmar que tus registros DNS son correctos. Reintentar con registros incorrectos no acelera la validación.

<div id="managing-a-custom-domain">
## Gestionar un dominio personalizado
</div>

<div id="default-subdomain-remains-active">
### El subdominio predeterminado permanece activo
</div>

La URL predeterminada de tu implementación `<subdomain>.mintlify.site` no puede desactivarse ni redirigirse por ahora, incluso después de que un dominio personalizado esté activo. Ambas URL sirven el mismo contenido. Establece una [URL canónica](#set-a-canonical-url) para que los motores de búsqueda indexen el dominio personalizado como el principal.

<div id="renaming-a-project">
### Renombrar un proyecto
</div>

Renombrar un proyecto en tu dashboard cambia únicamente el nombre visible. No cambia la URL de la implementación ni el nombre de host predeterminado `<subdomain>.mintlify.site`.

Si renombras un proyecto y luego ves un error `Disallowed origin host` en tu URL predeterminada, el nombre de host de la implementación ya no coincide con lo que tu dashboard espera. Para cambiar la URL, elimina la implementación y vuelve a crearla con el nombre deseado. No hay un renombrado en el sitio para la URL de la implementación.

<div id="releasing-a-domain">
### Liberar un dominio
</div>

Un dominio personalizado solo puede estar asociado a una implementación de Mintlify a la vez. Si tu dominio sigue asociado a una implementación u organización anterior (por ejemplo, tras trasladarte a un nuevo workspace), la nueva implementación no puede reclamarlo hasta que la anterior lo libere.

Para liberar un dominio que controlas:

1. Contacta con [soporte](mailto:support@mintlify.com) y solicita la liberación del dominio.
2. Soporte proporciona un registro `TXT` de verificación con un valor único.
3. Agrega el registro en tu proveedor de DNS:

```text
TXT | <tu-dominio> | <valor proporcionado por soporte>
```

4. Responde a soporte una vez que el registro esté activo. Soporte verifica el registro y desvincula el dominio de la implementación anterior. Luego puedes añadirlo a tu nueva implementación siguiendo [Agrega tu dominio personalizado](#add-your-custom-domain).

<div id="set-a-canonical-url">
## Establece una URL canónica
</div>
Expand Down
36 changes: 36 additions & 0 deletions fr/customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,42 @@ Après l’ajout d’un enregistrement `TXT` de vérification, la validation du

N’utilisez cette option qu’après avoir vérifié que vos enregistrements DNS sont corrects. Relancer la validation avec des enregistrements incorrects n’accélère pas le processus.

<div id="managing-a-custom-domain">
## Gérer un domaine personnalisé
</div>

<div id="default-subdomain-remains-active">
### Le sous-domaine par défaut reste actif
</div>

L’URL par défaut `<subdomain>.mintlify.site` de votre déploiement ne peut aujourd’hui être ni désactivée ni redirigée, même après la mise en service d’un domaine personnalisé. Les deux URL servent le même contenu. Définissez une [URL canonique](#set-a-canonical-url) pour que les moteurs de recherche indexent le domaine personnalisé comme URL principale.

<div id="renaming-a-project">
### Renommer un projet
</div>

Renommer un projet dans votre dashboard modifie uniquement le nom d’affichage. Cela ne change ni l’URL de déploiement ni le nom d’hôte par défaut `<subdomain>.mintlify.site`.

Si vous renommez un projet et voyez ensuite une erreur `Disallowed origin host` à votre URL par défaut, c’est que le nom d’hôte du déploiement ne correspond plus à ce que votre dashboard attend. Pour changer l’URL, supprimez le déploiement et recréez-le avec le nom souhaité. Il n’existe pas de renommage sur place de l’URL de déploiement.

<div id="releasing-a-domain">
### Libérer un domaine
</div>

Un domaine personnalisé ne peut être attaché qu’à un seul déploiement Mintlify à la fois. Si votre domaine est encore attaché à un déploiement ou une organisation précédent (par exemple, après un déplacement vers un nouveau workspace), le nouveau déploiement ne peut pas le revendiquer tant que l’ancien ne l’a pas libéré.

Pour libérer un domaine que vous contrôlez :

1. Contactez le [support](mailto:support@mintlify.com) et demandez la libération du domaine.
2. Le support fournit un enregistrement `TXT` de vérification avec une valeur unique.
3. Ajoutez l’enregistrement chez votre fournisseur DNS :

```text
TXT | <votre-domaine> | <valeur fournie par le support>
```

4. Répondez au support une fois l’enregistrement en ligne. Le support vérifie l’enregistrement et détache le domaine du déploiement précédent. Vous pouvez ensuite l’ajouter à votre nouveau déploiement en suivant [Ajoutez votre domaine personnalisé](#add-your-custom-domain).

<div id="set-a-canonical-url">
## Définir une URL canonique
</div>
Expand Down
36 changes: 36 additions & 0 deletions zh/customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,42 @@ DNS 记录生效后,你的文档最初将通过 HTTP 提供访问。TLS 证书

请仅在确认 DNS 记录正确后再使用该选项。使用错误的记录反复重试不会加快验证。

<div id="managing-a-custom-domain">
## 管理自定义域名
</div>

<div id="default-subdomain-remains-active">
### 默认子域名保持可用
</div>

即使自定义域名已经上线,你的部署所使用的默认 `<subdomain>.mintlify.site` URL 目前仍无法禁用或重定向。两个 URL 会提供相同的内容。请设置[规范 URL](#set-a-canonical-url),以便搜索引擎将自定义域名作为主域名进行索引。

<div id="renaming-a-project">
### 重命名项目
</div>

在 dashboard 中重命名项目仅会更改显示名称,不会更改部署 URL 或默认的 `<subdomain>.mintlify.site` 主机名。

如果你重命名项目后,在默认 URL 上看到 `Disallowed origin host` 错误,说明该部署的主机名与 dashboard 期望的名称不再匹配。若要更改 URL,请删除该部署,并使用期望的名称重新创建。部署 URL 无法就地重命名。

<div id="releasing-a-domain">
### 释放域名
</div>

一个自定义域名同一时间只能绑定到一个 Mintlify 部署。如果你的域名仍绑定在先前的部署或组织上(例如迁移到新的 workspace 后),新的部署在旧部署释放该域名之前无法认领它。

若要释放你所控制的域名:

1. 联系[支持团队](mailto:support@mintlify.com)并请求释放该域名。
2. 支持团队会提供一条带有唯一值的验证 `TXT` 记录。
3. 在你的 DNS 提供商处添加该记录:

```text
TXT | <你的域名> | <支持团队提供的值>
```

4. 记录生效后回复支持团队。支持团队会验证该记录,并将域名从先前的部署解绑。随后你可以按照[添加自定义域名](#add-your-custom-domain)将其添加到新的部署。

<div id="set-a-canonical-url">
## 设置规范 URL
</div>
Expand Down
Loading