---
title: Conecte um domínio personalizado
description: Adicione, compre, transfira, renove ou solucione problemas de um domínio para uma loja Runner publicada.
---

**Caminho de entrada:** No desktop quando mostrado, abra Espaço de Trabalho → selecione uma loja → **Loja** → menu de site publicado → **Configurações de Domínio**. No celular, ou quando esse menu está oculto, use **Configurações** do espaço de trabalho → **Loja: _nome da loja_** → **Domínio**.

![Configurações de domínio do Runner](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgYGF1bf76kHwFTWJcAfZ3G7eO08Mhysu1iQRg)

## O que este guia cobre

Abra Configurações de Domínio para uma loja publicada, escolha o fluxo de trabalho de domínio correto e compreenda o que cada ação de alto impacto altera antes de continuar.

## Por que e quando usar um domínio personalizado

Um domínio personalizado oferece aos clientes um endereço marcado para a loja publicada. Conecte um após a primeira publicação bem-sucedida e após a loja funcionar em sua URL pública existente. Isso isola problemas de domínio de problemas de loja, catálogo e checkout.

## Disponibilidade e pré-requisitos

- O acesso a **domínio personalizado** depende do plano.
- A loja deve ter uma publicação bem-sucedida antes que os controles de domínio fiquem disponíveis.
- Você precisa de acesso às configurações do projeto.
- Adicionar um domínio que você já possui requer permissão para alterar seus registros DNS no seu provedor de DNS.
- Comprar ou renovar um domínio inicia um fluxo de pagamento externo.
- Transferir um domínio entre lojas no mesmo espaço de trabalho é limitado a proprietários e administradores do espaço de trabalho.

## Abra Configurações de Domínio

1. Abra seu projeto e selecione **Loja**.
2. Selecione o menu de site publicado que mostra o domínio ativo.
3. Selecione **Configurações de Domínio**.

Você também pode abrir **Configurações** do espaço de trabalho, encontrar a seção rotulada **Loja: _nome da loja_**, depois selecionar **Domínio**.

## Controles de domínio

| Controle | Por que você o usa | O que acontece quando você o seleciona |
| --- | --- | --- |
| **Como conectar domínio personalizado?** | Abra a ajuda de conexão atual. | A página de ajuda abre em uma nova aba. |
| **Insira seu endereço de domínio** + **Continuar** | Anexe um domínio que você já possui. | O Runner valida e anexa o endereço e depois detecta o provedor de DNS. **Domínio adicionado com sucesso** confirma apenas o anexo; o DNS e a propriedade são verificados separadamente. O controle não está disponível antes da primeira publicação bem-sucedida. |
| **Continuar para o Cloudflare** | Permita que o Runner adicione os registros necessários para um domínio compatível gerenciado pelo Cloudflare. | O Runner abre a página de autorização do Cloudflare. Escolha a conta que contém o domínio e autorize o acesso DNS do Runner. Ao retornar, o Runner grava os registros exatos necessários e inicia uma nova verificação de conexão. Esta opção aparece somente quando a configuração automática está disponível. |
| **Usar registros manuais** | Mude de um fluxo automático oferecido para a configuração manual de DNS. | Selecione esta opção para mostrar os registros exatos de **Tipo / Host / Valor**. Quando a configuração automática não está disponível, o Runner mostra esses registros diretamente. Adicione todos os registros exibidos no seu provedor de DNS e depois retorne ao Runner. |
| **Adicionei os registros** | Verifique o DNS imediatamente depois de salvar os registros manuais. | O Runner verifica automaticamente; ao selecionar este botão, você evita a espera inicial e verifica imediatamente tanto os registros de roteamento quanto qualquer desafio de propriedade. Uma autorização bem-sucedida do provedor, por si só, não marca o domínio como conectado. |
| Ícone limpar no campo de domínio | Remova o valor digitado. | A entrada é limpa; nenhum domínio é alterado. |
| **Comprar um Domínio** pesquisa + **Pesquisar** | Encontre domínios oferecidos para compra. | O Runner lista resultados disponíveis ou explica que o domínio solicitado não está disponível. |
| **Comprar** | Comece a comprar um domínio disponível selecionado. | O Runner abre **Informações de Contato** com o domínio e preço exibidos. Nenhuma compra ocorre ainda. |
| **Prosseguir para Pagamento** | Continue uma compra ou renovação de domínio. | O Runner redireciona para um checkout externo. Isso pode criar uma cobrança se você concluir. Revise os detalhes exibidos primeiro. |
| **Transferir um Domínio** / **Escolha um domínio para transferir** | Mova um domínio elegível de outra loja no mesmo espaço de trabalho. | Selecionar um domínio abre uma confirmação nomeando as lojas de origem e destino. Confirmar inicia a transferência; a loja de origem perde esse domínio. |
| Endereço de domínio em **Seus Domínios** | Abra o site nesse endereço. | O domínio abre em uma nova aba do navegador. |
| Copiar ao lado de **Host** ou **Valor** | Use o registro DNS exato que o Runner recomenda. | O **Host** ou **Valor** selecionado é copiado para uso no seu provedor de DNS. Digite o **Tipo** exibido separadamente. |
| Remover domínio | Desanexe um domínio personalizado. | O Runner abre **Remover Domínio**. Selecionar **Remover** confirma uma alteração que o diálogo descreve como irreversível. |
| **Renovar** | Estenda um domínio comprado elegível mostrado próximo ao vencimento. | O Runner abre opções de renovação e um total antes de **Prosseguir para Pagamento**. |
| **Tentar Novamente** em uma transferência falhada | Inicie outra tentativa de transferência. | O Runner inicia uma tentativa nova para o mesmo domínio selecionado. |
| **Fechar** em uma transferência falhada | Saia do diálogo de transferência falhada. | O diálogo fecha sem iniciar a tentativa novamente. |
| Fechar ou X durante **Transferência em andamento** | Descarte o diálogo de progresso | A transferência do lado do servidor continua; fechar o diálogo não a cancela. Retorne mais tarde para inspecionar o status e não inicie outra transferência. |

## Conecte um domínio que você já possui

1. Confirme que a loja funciona em sua URL publicada atual.
2. Abra **Configurações de Domínio**.
3. Digite o domínio completo que você controla e selecione **Continuar**.
4. **Domínio adicionado com sucesso** significa que o Runner aceitou e anexou o endereço. Isso não confirma que o DNS esteja configurado nem que o site esteja online.
5. Escolha um método de configuração:
   - Se o Runner detectar uma configuração compatível do Cloudflare, selecione **Continuar para o Cloudflare**, escolha a conta do Cloudflare que contém o domínio e autorize o acesso DNS do Runner. Ao retornar, o Runner grava os registros exatos mostrados nas configurações de domínio.
   - Se um fluxo automático for oferecido e você preferir a configuração manual, selecione **Usar registros manuais**. Se a configuração automática não estiver disponível, os registros já estarão exibidos. Adicione todos os registros exibidos de **Tipo / Host / Valor** no seu provedor de DNS.
6. Depois de salvar os registros manuais, selecione **Adicionei os registros** para evitar a espera inicial e verificar imediatamente. O Runner também verifica automaticamente enquanto uma conexão está pendente e quando você retorna do Cloudflare.
7. Aguarde o status conectado. O Runner exige que tanto os registros de roteamento quanto a propriedade do domínio sejam verificados; concluir apenas a autorização do Cloudflare não comprova a conexão.
8. Abra o domínio em **Seus Domínios** e verifique novamente a loja pública, o produto, o carrinho e o checkout no endereço personalizado.

## Compre, transfira, renove ou remova com cuidado

- **Comprar:** Pesquise, selecione **Comprar**, revise o domínio e preço atual, digite informações de contato precisas, depois continue para pagamento apenas quando pretender comprá-lo.
- **Transferir:** Leia a origem e destino nomeados. A confirmação diz que a loja de origem perde o domínio e que desfazer imediato não está disponível. Não confirme enquanto essa loja de origem ainda precisar do endereço. Fechar o diálogo de progresso não cancela uma transferência ativa.
- **Renovar:** Revise o período de renovação e total antes de continuar para pagamento.
- **Remover:** Certifique-se de que outro domínio funcionando existe e registre a configuração atual antes de selecionar **Remover**. A confirmação avisa que a remoção não pode ser desfeita.

## Estados, limites e solução de problemas

| O que você vê | Significado | O que fazer |
| --- | --- | --- |
| **Por favor, publique primeiro** | O projeto não tem publicação bem-sucedida ainda. | Publique e verifique a URL pública existente antes de adicionar um domínio personalizado. |
| **Nenhum domínio encontrado** | Nenhum domínio está anexado atualmente. | Adicione um domínio que você possui ou pesquise um para comprar. |
| **Por favor, digite um domínio válido** | O Runner rejeitou o formato do endereço. | Corrija o endereço e tente novamente. |
| **Domínio já está anexado a outra loja** | Outra loja neste espaço de trabalho o usa. | Um proprietário ou administrador pode selecionar **Transferir em vez disso?**; outros membros devem contatar um administrador. |
| **Domínio adicionado com sucesso** | O Runner aceitou e anexou o endereço. A configuração DNS é verificada separadamente. | Leia o estado da linha do domínio antes de considerar o endereço pronto. |
| **Continuar para o Cloudflare** não é exibido | A configuração automática não está disponível para este domínio no momento ou o serviço de conexão do Cloudflare não está pronto. | Use os registros DNS manuais exibidos na linha do domínio. Não espere uma opção automática aparecer. |
| Registros DNS manuais e **Adicionei os registros** | O domínio próprio está anexado, mas o roteamento ou a verificação de propriedade ainda não passou. | Adicione exatamente todos os registros exibidos, aguarde a propagação do DNS e selecione **Adicionei os registros** para verificar imediatamente. O Runner continua verificando automaticamente. |
| Status de verificação após retornar do Cloudflare | O Runner está lendo o estado real do DNS e da propriedade. | Mantenha a página aberta ou retorne mais tarde. Se não houver conexão, use os registros manuais e verifique novamente. |
| Marca azul e desaparecimento dos controles DNS do domínio | Tanto a configuração DNS atual quanto a verificação de propriedade passaram. | Abra o domínio e verifique toda a jornada do cliente; a marca por si só não prova que a loja ou o checkout funcionem. |
| Indicador de carregamento com **Configurando domínio — disponível em alguns minutos** | Um domínio comprado pelo Runner ainda está sendo configurado. | Não aplique a este estado as instruções DNS manuais para domínios próprios. Retorne mais tarde; nenhum tempo de conclusão fixo é garantido. |
| **Transferência em andamento** | Uma movimentação de domínio do espaço de trabalho foi iniciada. | Evite iniciar outra movimentação para o mesmo domínio. Fechar o diálogo apenas o descarta; a transferência continua no servidor. Retorne mais tarde para inspecionar o resultado. |
| Transferência falhada | A movimentação não foi concluída. | Leia o erro, depois selecione **Tentar Novamente** ou **Fechar**. Confirme qual loja ainda possui o domínio antes de outra ação. |
| Compra ou renovação falhada | O pagamento externo não foi concluído. | Siga o status exibido pelo Runner e confirme qualquer estado de reembolso antes de tentar outro pagamento. |

## Guias relacionadas

- [Publique e republique](./publish-and-republish)
- [Verifique a loja ativa e checkout](./live-store-and-checkout)
- [Solucione problemas de visualização e publicação](./troubleshoot-preview-and-publishing)