---
title: Conectar uma Loja Shopify
description: Crie um projeto Runner em torno de uma loja Shopify existente mantendo o checkout no Shopify.
---

**O que este guia cobre:** Você iniciará a autorização do Shopify ou reutilizará uma conexão Shopify elegível para um novo projeto Runner.

Use este caminho quando seu catálogo e checkout já estão no Shopify.

**Caminho de entrada:** Espaço de trabalho **Início** → **+ Loja** → **Conectar Shopify**.

## Antes de começar

- **Conectar Shopify** deve estar habilitado para seu espaço de trabalho.
- Você precisa do domínio permanente da loja terminando em `.myshopify.com`.
- Para uma nova conexão, você precisa de permissão para aprovar acesso no Shopify.
- Seu espaço de trabalho Runner deve ter espaço para outra loja.

## Controles de Criar Loja

| Controle | Por que é útil | O que acontece após selecioná-lo |
| --- | --- | --- |
| Tipo de projeto **Conectar Shopify** | Mantém o sistema de comércio Shopify existente. | Mostra opções de conexão Shopify e o campo de domínio da loja. |
| **Nome da Loja** | Nomeia o projeto Runner. | Usado no espaço de trabalho Runner; não renomeia a loja Shopify. |
| **Usar conexão existente: _domínio_** | Evita repetir autorização para uma conexão elegível. | Seleciona essa conexão Shopify para o novo projeto Runner. |
| **Conectar uma loja diferente** | Começa com outra loja Shopify. | Mostra **Domínio da loja**. |
| **Domínio da loja** | Identifica a loja Shopify. | Aceita um domínio como `your-store.myshopify.com`. |
| Botão de envio **Conectar Shopify** | Inicia uma nova autorização. | Envia você para Shopify; o Runner conclui a transferência apenas após o Shopify retornar com sucesso. |
| **Criar** | Usa a conexão existente selecionada. | Cria o projeto Runner e o abre. |
| **Cancelar** | Sai sem conectar ou criar. | Fecha o diálogo. |

## Conecte uma nova loja Shopify

1. Selecione **+ Loja**, depois escolha **Conectar Shopify**.
2. Digite um **Nome da Loja** para o projeto Runner.
3. Escolha **Conectar uma loja diferente** se as opções de conexão forem mostradas.
4. Digite o domínio completo `.myshopify.com` em **Domínio da loja**.
5. Selecione **Conectar Shopify**.
6. Revise a solicitação de acesso no Shopify e continue apenas se nomear a loja que você espera.
7. Após o Shopify retornar ao Runner, confirme que o novo projeto aparece no espaço de trabalho.

## Reutilize uma conexão existente

1. Escolha **Conectar Shopify** em **Criar Loja**.
2. Digite o **Nome da Loja** do Runner.
3. Selecione **Usar conexão existente: _domínio_**.
4. Selecione **Criar**.

## Solução de problemas

| Estado | Significado | O que fazer |
| --- | --- | --- |
| Opção Shopify está ausente | O recurso não está habilitado para este espaço de trabalho. | Use **Construir novo** ou verifique a disponibilidade do espaço de trabalho. |
| **Conectar Shopify** está desabilitado | O nome da loja ou domínio `.myshopify.com` está incompleto. | Corrija o campo destacado. |
| Conexão já vinculada | Essa conexão Shopify pertence a outra loja Runner. | Escolha outra conexão elegível ou uma loja diferente. |
| Conexão não encontrada | Uma conexão salva não está mais disponível. | Selecione outra conexão ou inicie uma nova autorização. |
| Autorização Shopify é cancelada | Shopify não retornou uma conexão aprovada. | Retorne a **Criar Loja** e tente novamente quando estiver pronto. |

O checkout permanece no Shopify para este tipo de projeto. Uma conexão bem-sucedida não prova que
a vitrine Runner foi construída ou publicada; revise esses estados separadamente.

## Guias relacionados

- [Criar uma loja Runner em vez disso](./create-runner-store.mdx)
- [Construir sua primeira loja](./first-store-quickstart.mdx)
- [Começar](./)