# Configurando um domínio personalizado

Por padrão, seu site é publicado em um subdomínio da nossa plataforma. Você pode trocar isso pelo seu próprio domínio (por exemplo, `docs.yourcompany.com`) em qualquer plano pago.

### Pré-requisitos

* Um plano pago (Pro ou acima)
* Acesso às configurações de DNS do seu domínio
* Um site publicado

### Passos

{% stepper %}
{% step %}

### Adicione seu domínio nas configurações

Vá para **Configurações → Publicação → Domínio personalizado** e digite o domínio ou subdomínio que você quer usar (por exemplo, `docs.yourcompany.com`). Clique **Salvar**.
{% endstep %}

{% step %}

### Criar um registro CNAME

No seu provedor de DNS, crie um registro CNAME apontando seu subdomínio para o endereço mostrado nas suas configurações. As mudanças podem levar até 48 horas para se propagar, embora normalmente seja bem mais rápido.

```
Tipo:  CNAME
Nome:  docs
Valor: sites.example-platform.com
```

{% endstep %}

{% step %}

### Verificar e ativar

Volte para **Configurações → Publicação → Domínio personalizado** e clique em **Verificar**. Depois da verificação, o SSL é provisionado automaticamente — isso normalmente leva alguns minutos.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Usando um domínio apex (por exemplo, `yourcompany.com` sem subdomínio)? Você vai precisar definir um registro ALIAS ou ANAME em vez de um CNAME. Nem todos os provedores de DNS oferecem isso — veja a documentação do seu provedor.
{% endhint %}

### Solução de problemas

**A verificação continua falhando** Certifique-se de que não existam registros DNS conflitantes para o mesmo subdomínio. Um registro A existente vai bloquear o CNAME.

**O certificado SSL não está sendo provisionado** O SSL é emitido automaticamente depois da verificação do DNS. Se ele não aparecer depois de 30 minutos, tente clicar em **Verificar** de novo.

**O site abre, mas mostra um aviso de SSL** Isso normalmente significa um certificado em cache ou antigo. Tente limpar o cache do seu navegador ou espere mais alguns minutos para a propagação ser concluída.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://isbm.savimbo.com/practice-guide/pt-br/como-comecar/configurando-um-dominio-personalizado.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.