---
title: Einen Shopify-Store verbinden
description: Erstellen Sie ein Runner-Projekt um einen vorhandenen Shopify-Store, während Sie den Checkout in Shopify behalten.
---

**Was dieser Leitfaden abdeckt:** Sie werden die Shopify-Autorisierung starten oder eine berechtigte Shopify-Verbindung für ein neues Runner-Projekt wiederverwenden.

Verwenden Sie diesen Pfad, wenn Ihr Katalog und Checkout bereits in Shopify live sind.

**Einstiegspfad:** Workspace **Startseite** → **+ Store** → **Shopify verbinden**.

## Bevor Sie beginnen

- **Shopify verbinden** muss für Ihren Workspace aktiviert sein.
- Sie benötigen die permanente Domain des Stores, die mit `.myshopify.com` endet.
- Für eine neue Verbindung benötigen Sie die Berechtigung, den Zugriff in Shopify zu genehmigen.
- Ihr Runner-Workspace muss Platz für einen weiteren Store haben.

## Store-Steuerelemente erstellen

| Steuerelement | Warum es nützlich ist | Was nach der Auswahl passiert |
| --- | --- | --- |
| **Shopify verbinden** Projekttyp | Behält das vorhandene Shopify-Commerce-System. | Zeigt Shopify-Verbindungsoptionen und das Shop-Domain-Feld. |
| **Store-Name** | Benennt das Runner-Projekt. | Wird im Runner-Workspace verwendet; es benennt den Shopify-Shop nicht um. |
| **Vorhandene Verbindung verwenden: _domain_** | Vermeidet wiederholte Autorisierung für eine berechtigte Verbindung. | Wählt diese Shopify-Verbindung für das neue Runner-Projekt aus. |
| **Einen anderen Store verbinden** | Beginnt mit einem anderen Shopify-Shop. | Zeigt **Shop-Domain**. |
| **Shop-Domain** | Identifiziert den Shopify-Store. | Akzeptiert eine Domain wie `your-store.myshopify.com`. |
| **Shopify verbinden** Absendeschaltfläche | Startet eine neue Autorisierung. | Sendet Sie zu Shopify; Runner beendet die Übergabe nur, nachdem Shopify erfolgreich zurückgekehrt ist. |
| **Erstellen** | Verwendet die ausgewählte vorhandene Verbindung. | Erstellt das Runner-Projekt und öffnet es. |
| **Abbrechen** | Verlässt ohne Verbindung oder Erstellung. | Das Dialogfeld wird geschlossen. |

## Verbinden Sie einen neuen Shopify-Store

1. Wählen Sie **+ Store**, dann wählen Sie **Shopify verbinden**.
2. Geben Sie einen **Store-Namen** für das Runner-Projekt ein.
3. Wählen Sie **Einen anderen Store verbinden**, wenn Verbindungsoptionen angezeigt werden.
4. Geben Sie die vollständige `.myshopify.com`-Domain in **Shop-Domain** ein.
5. Wählen Sie **Shopify verbinden**.
6. Überprüfen Sie die Zugriffanfrage auf Shopify und fahren Sie nur fort, wenn sie den erwarteten Store benennt.
7. Nachdem Shopify zu Runner zurückgekehrt ist, bestätigen Sie, dass das neue Projekt im Workspace angezeigt wird.

## Verwenden Sie eine vorhandene Verbindung erneut

1. Wählen Sie **Shopify verbinden** in **Store erstellen**.
2. Geben Sie den Runner **Store-Namen** ein.
3. Wählen Sie **Vorhandene Verbindung verwenden: _domain_**.
4. Wählen Sie **Erstellen**.

## Fehlerbehebung

| Status | Bedeutung | Was zu tun ist |
| --- | --- | --- |
| Shopify-Option fehlt | Die Funktion ist für diesen Workspace nicht aktiviert. | Verwenden Sie **Neu erstellen** oder überprüfen Sie die Workspace-Verfügbarkeit. |
| **Shopify verbinden** ist deaktiviert | Der Store-Name oder die `.myshopify.com`-Domain ist unvollständig. | Korrigieren Sie das hervorgehobene Feld. |
| Verbindung bereits verlinkt | Diese Shopify-Verbindung gehört zu einem anderen Runner-Store. | Wählen Sie eine andere berechtigte Verbindung oder einen anderen Shop. |
| Verbindung nicht gefunden | Eine gespeicherte Verbindung ist nicht mehr verfügbar. | Wählen Sie eine andere Verbindung oder starten Sie eine neue Autorisierung. |
| Shopify-Autorisierung ist abgebrochen | Shopify hat keine genehmigte Verbindung zurückgegeben. | Kehren Sie zu **Store erstellen** zurück und versuchen Sie es erneut, wenn Sie bereit sind. |

Der Checkout bleibt in Shopify für diesen Projekttyp. Eine erfolgreiche Verbindung beweist nicht, dass
die Runner-Storefront erstellt oder veröffentlicht ist; überprüfen Sie diese Status separat.

## Verwandte Leitfäden

- [Erstellen Sie stattdessen einen Runner-Store](./create-runner-store.mdx)
- [Erstellen Sie Ihren ersten Store](./first-store-quickstart.mdx)
- [Erste Schritte](./)