---
title: "Domaines"
description: "Connectez votre propre domaine à l’aide d’un enregistrement TXT et d’un enregistrement CNAME, puis choisissez l’adresse principale."
canonical: "https://atelier201.com/docs/fr/platform/domains"
updated: "2026-11-06"
---

# Domaines

Chaque site répond à l’adresse `<slug>.atelier201.page`. Un Site peut aussi répondre sur votre propre
domaine. Il peut avoir jusqu’à 3 adresses (par exemple `www.example.com`, `example.com`
et un ancien domaine), et toutes les adresses sauf la principale redirigent vers celle-ci. Un brouillon n’a pas
de domaine personnalisé.
La connexion ou la suppression d’un domaine nécessite le scope `domains:write` et un administrateur
d’espace de travail.

## Connecter un domaine

Utilisez un sous-domaine, comme `www.example.com`. C’est le choix le plus fiable. Un domaine racine
tel que `example.com` dépend de ce que votre fournisseur DNS prend en charge.

1. Ajoutez le domaine dans l’application (**Domaines**), avec `atelier201 domains add` ou via
   [Connecter un domaine](/docs/api/domains/add). Atelier201 l’enregistre et renvoie les enregistrements DNS à créer.
2. Créez ces enregistrements chez votre fournisseur DNS :
   - un enregistrement **TXT** qui prouve que vous possédez le domaine ;
   - un enregistrement **CNAME** qui dirige le domaine vers Atelier201.
3. Vérifiez le domaine. Atelier201 effectue aussi automatiquement une vérification toutes les 5 minutes.

Copiez les noms et les valeurs des enregistrements depuis la réponse ou l’application, jamais depuis
un autre site : ils sont propres à votre domaine. Le routage ne commence qu’une fois l’enregistrement TXT
détecté. C’est intentionnel : personne ne peut revendiquer un domaine en se contentant de le déclarer.

## États

Un domaine passe automatiquement à l’étape suivante dès que les enregistrements sont en place.

| État                | Signification                                                               |
| ------------------- | --------------------------------------------------------------------------- |
| `pending_ownership` | En attente de l’enregistrement TXT.                                         |
| `provisioning`      | La propriété est confirmée. Atelier201 génère le certificat.                |
| `active`            | Le site répond sur ce domaine en HTTPS.                                     |
| `error`             | Une erreur s’est produite. Le champ `error` du domaine en indique la cause. |
| `removing`          | La déconnexion du domaine est en cours.                                     |

La propagation des changements DNS peut prendre du temps. Si un domaine reste à l’état `pending_ownership`,
vérifiez d’abord les enregistrements chez votre fournisseur DNS. Consultez
[Résolution des problèmes](/docs/platform/troubleshooting).

## Choisir l’adresse principale

Lorsqu’un site possède plusieurs adresses, l’une d’elles est l’adresse principale. Les visiteurs qui utilisent
les autres sont redirigés vers celle-ci, et les liens canoniques ainsi que le plan du site l’utilisent.
Choisir une nouvelle adresse principale déclenche une nouvelle compilation, car ces liens sont générés au moment
de la compilation. Publiez cette compilation pour terminer.

## Supprimer un domaine

Le site cesse de répondre sur le domaine en une minute environ. Son adresse
`atelier201.page` continue de fonctionner.