---
title: "Domínios"
description: "Conecte seu próprio domínio com um registro TXT e um CNAME e escolha o endereço principal."
canonical: "https://atelier201.com/docs/pt/platform/domains"
updated: "2026-11-06"
---

# Domínios

Todo site responde em `<slug>.atelier201.page`. Um Site também pode responder no seu próprio
domínio. Ele aceita até 3 endereços (por exemplo, `www.example.com`, `example.com`
e um domínio antigo), e todos, exceto o principal, redirecionam para ele. Um rascunho não tem
domínio personalizado.
Para conectar ou remover um domínio, é necessário ter o escopo `domains:write` e ser administrador do workspace.

## Conectar um domínio

Use um subdomínio, como `www.example.com`. É a opção mais confiável. Um domínio raiz,
como `example.com`, depende do que seu provedor de DNS oferece.

1. Adicione o domínio no app (**Domains**), com `atelier201 domains add` ou usando
   [Conectar um domínio](/docs/api/domains/add). O Atelier201 registra o domínio e retorna os
   registros DNS que você deve criar.
2. Crie esses registros no seu provedor de DNS:
   - um registro **TXT** que comprova que você é proprietário do domínio;
   - um registro **CNAME** que aponta o domínio para o Atelier201.
3. Verifique o domínio. O Atelier201 também faz essa verificação automaticamente a cada 5 minutos.

Copie os nomes e valores dos registros da resposta ou do app, nunca de
outro site: eles são específicos do seu domínio. Nenhum tráfego é direcionado até que o registro TXT
seja detectado. Isso é intencional. Ninguém pode reivindicar um domínio apenas declarando que é seu.

## Estados

O domínio avança automaticamente quando os registros estão configurados.

| Estado              | Significado                                                       |
| ------------------- | ----------------------------------------------------------------- |
| `pending_ownership` | Aguardando o registro TXT.                                        |
| `provisioning`      | Propriedade comprovada. O Atelier201 está emitindo o certificado. |
| `active`            | O site responde neste domínio por HTTPS.                          |
| `error`             | Algo deu errado. O campo `error` do domínio informa o motivo.     |
| `removing`          | O domínio está sendo desconectado.                                |

As alterações de DNS podem levar um tempo para se propagar. Se o domínio continuar em `pending_ownership`,
verifique primeiro os registros no seu provedor de DNS. Consulte
[Solução de problemas](/docs/platform/troubleshooting).

## Escolher o endereço principal

Quando um site tem vários endereços, um deles é o principal. Os visitantes dos
outros são redirecionados para ele, e os links canônicos e o sitemap usam esse endereço.
Escolher um novo endereço principal inicia uma nova compilação, pois esses links são gerados durante
a compilação. Publique essa compilação para concluir.

## Remover um domínio

O site deixa de responder nesse domínio em cerca de um minuto. O endereço
`atelier201.page` continua funcionando.