---
title: "Domini"
description: "Collega il tuo dominio con un record TXT e uno CNAME e scegli l’indirizzo principale."
canonical: "https://atelier201.com/docs/it/platform/domains"
updated: "2026-11-06"
---

# Domini

Ogni sito risponde all’indirizzo `<slug>.atelier201.page`. Un Site può rispondere anche al tuo
dominio. Può avere fino a 3 indirizzi (per esempio `www.example.com`, `example.com`
e un dominio precedente); tutti, tranne quello principale, reindirizzano a quest’ultimo. Una bozza non ha
un dominio personalizzato.
Per collegare o rimuovere un dominio servono l’ambito `domains:write` e i privilegi di amministratore dell’area di lavoro.

## Collegare un dominio

Usa un sottodominio, ad esempio `www.example.com`: è la scelta più affidabile. Un dominio
apex, come `example.com`, dipende dalle funzionalità supportate dal tuo provider DNS.

1. Aggiungi il dominio nell’app (**Domains**), con `atelier201 domains add` oppure tramite
   [Connect a domain](/docs/api/domains/add). Atelier201 lo registra e restituisce i
   record DNS da creare.
2. Crea i record presso il tuo provider DNS:
   - un record **TXT** che dimostri che il dominio è tuo;
   - un record **CNAME** che punti il dominio ad Atelier201.
3. Verifica il dominio. Atelier201 esegue anche una verifica automatica ogni 5 minuti.

Copia nomi e valori dei record dalla risposta o dall’app, mai da un altro
sito: sono specifici del tuo dominio. Il traffico non viene instradato finché non viene rilevato il record TXT.
È una scelta intenzionale: nessuno può rivendicare un dominio limitandosi a dichiararlo.

## Stati

Una volta creati i record, il dominio avanza automaticamente.

| Stato               | Significato                                                                   |
| ------------------- | ----------------------------------------------------------------------------- |
| `pending_ownership` | In attesa del record TXT.                                                     |
| `provisioning`      | La proprietà è stata verificata. Atelier201 sta rilasciando il certificato.   |
| `active`            | Il sito è raggiungibile su questo dominio tramite HTTPS.                      |
| `error`             | Si è verificato un problema. Il campo `error` del dominio ne indica la causa. |
| `removing`          | Il dominio è in fase di scollegamento.                                        |

Le modifiche DNS possono impiegare tempo a propagarsi. Se un dominio resta in `pending_ownership`,
controlla prima i record presso il tuo provider DNS. Consulta la
[Risoluzione dei problemi](/docs/platform/troubleshooting).

## Scegliere l’indirizzo principale

Se un sito ha più indirizzi, uno è quello principale. I visitatori degli
altri vengono reindirizzati a questo, che viene usato anche nei link canonici e nella sitemap.
La scelta di un nuovo indirizzo principale avvia una nuova build, perché questi link vengono generati
al momento della build. Pubblica la build per completare l’operazione.

## Rimuovere un dominio

Il sito smette di rispondere sul dominio entro circa un minuto. L’indirizzo
`atelier201.page` continua a funzionare.