---
title: Connetti un negozio Shopify
description: Crea un progetto Runner attorno a un negozio Shopify esistente mantenendo il checkout in Shopify.
---

**Cosa copre questa guida:** Avvierai l'autorizzazione di Shopify o riutilizzerai una connessione Shopify idonea per un nuovo progetto Runner.

Usa questo percorso quando il tuo catalogo e il checkout vivono già in Shopify.

**Percorso di accesso:** Workspace **Home** → **+ Negozio** → **Connetti Shopify**.

## Prima di iniziare

- **Connetti Shopify** deve essere abilitato per il tuo workspace.
- Hai bisogno del dominio permanente del negozio che termina con `.myshopify.com`.
- Per una nuova connessione, hai bisogno del permesso di approvare l'accesso in Shopify.
- Il tuo workspace Runner deve avere spazio per un altro negozio.

## Controlli di Crea negozio

| Controllo | Perché è utile | Cosa accade dopo averlo selezionato |
| --- | --- | --- |
| Tipo di progetto **Connetti Shopify** | Mantiene il sistema di commerce Shopify esistente. | Mostra le scelte di connessione Shopify e il campo del dominio del negozio. |
| **Nome del negozio** | Nomina il progetto Runner. | Usato nel workspace Runner; non rinomina il negozio Shopify. |
| **Usa connessione esistente: _dominio_** | Evita di ripetere l'autorizzazione per una connessione idonea. | Seleziona quella connessione Shopify per il nuovo progetto Runner. |
| **Connetti un negozio diverso** | Inizia con un altro negozio Shopify. | Mostra **Dominio del negozio**. |
| **Dominio del negozio** | Identifica il negozio Shopify. | Accetta un dominio come `your-store.myshopify.com`. |
| Pulsante di invio **Connetti Shopify** | Avvia una nuova autorizzazione. | Ti invia a Shopify; Runner termina il passaggio solo dopo che Shopify ritorna con successo. |
| **Crea** | Usa la connessione esistente selezionata. | Crea il progetto Runner e lo apre. |
| **Annulla** | Lascia senza connettere o creare. | Chiude la finestra di dialogo. |

## Connetti un nuovo negozio Shopify

1. Seleziona **+ Negozio**, quindi scegli **Connetti Shopify**.
2. Inserisci un **Nome del negozio** per il progetto Runner.
3. Scegli **Connetti un negozio diverso** se vengono mostrate scelte di connessione.
4. Inserisci il dominio completo `.myshopify.com` in **Dominio del negozio**.
5. Seleziona **Connetti Shopify**.
6. Rivedi la richiesta di accesso su Shopify e continua solo se nomina il negozio che ti aspetti.
7. Dopo che Shopify ritorna a Runner, conferma che il nuovo progetto appaia nel workspace.

## Riutilizza una connessione esistente

1. Scegli **Connetti Shopify** in **Crea negozio**.
2. Inserisci il **Nome del negozio** di Runner.
3. Seleziona **Usa connessione esistente: _dominio_**.
4. Seleziona **Crea**.

## Risoluzione dei problemi

| Stato | Significato | Cosa fare |
| --- | --- | --- |
| L'opzione Shopify è mancante | La funzione non è abilitata per questo workspace. | Usa **Costruisci nuovo** o controlla la disponibilità del workspace. |
| **Connetti Shopify** è disabilitato | Il nome del negozio o il dominio `.myshopify.com` è incompleto. | Correggi il campo evidenziato. |
| Connessione già collegata | Quella connessione Shopify appartiene a un altro negozio Runner. | Scegli un'altra connessione idonea o un negozio diverso. |
| Connessione non trovata | Una connessione salvata non è più disponibile. | Seleziona un'altra connessione o avvia una nuova autorizzazione. |
| L'autorizzazione di Shopify è annullata | Shopify non ha restituito una connessione approvata. | Torna a **Crea negozio** e riprova quando sei pronto. |

Il checkout rimane in Shopify per questo tipo di progetto. Una connessione riuscita non prova che
il negozio Runner sia costruito o pubblicato; rivedi quegli stati separatamente.

## Guide correlate

- [Crea un negozio Runner](./create-runner-store.mdx)
- [Costruisci il tuo primo negozio](./first-store-quickstart.mdx)
- [Inizia](./)