# Mit CSV-Dateien importieren

Mit dem CSV-Import erstellen oder aktualisieren Sie schnell Produkte (und Bestand) in Ihrem Shopify-Shop über eine Tabellendatei.

## ✅ Bevor Sie beginnen (Voraussetzungen)

#### 📌 CSV-Datei vorbereiten

Stellen Sie sicher, dass Ihre CSV-Datei Folgendes enthält:

* **Spaltenüberschriften** in der ersten Zeile (z. B. `Handle`, `Title`, `Vendor`)
* Einen **eindeutigen Schlüssel**, mit dem Datensätze abgeglichen werden (empfohlen: **Handle**)
* Das richtige Format (CSV-Datei)

#### 🔑 Empfohlener Primärschlüssel

* **Produkt-Handle (Product Handle)** (für die meisten Importe am besten geeignet)
* Je nach Ihren Daten sehen Sie möglicherweise auch andere Schlüssel (z. B. Produkt-ID, Varianten-SKU)

***

## 🛠️ Schritte zum Hochladen der Datei&#x20;

### CSV-Uploads in der Tipo-App öffnen

<figure><img src="/media/2a19292f386ccfa6c516.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

1. Öffnen Sie im Shopify Admin **Apps → Tipo Sync**
2. Klicken Sie auf **CSV-Uploads (CSV uploads)**
3. Klicken Sie auf **CSV-Datei hinzufügen (Add csv file)**

Sie gelangen zum Import-Assistenten (**Fortschritt 1/3**).

***

### 📤 Schritt 1/3 – CSV hochladen&#x20;

<figure><img src="/media/e3560f7f8a801b3726ec.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Upload-Quelle wählen**

Sie können die CSV-Datei hochladen über:

* **CSV-Import (CSV Import)** (Datei von Ihrem Computer hochladen)
* Import über Weblink (URL)
* Upload über FTP-Server
* Upload über SFTP-Server

#### **CSV-Optionen wählen**

**Trennzeichen (Separator)**

* Komma (am gebräuchlichsten)
* Semikolon
* Sonstiges

**CSV-Daten (CSV Data)**

* **Produkt (Product)** (für Produktfelder wie Titel, Beschreibung, Anbieter …)
* **Bestand (Inventory)** (für Bestandsmengen)

Klicken Sie anschließend auf **Nächster Schritt (Next Step)**.

<figure><span class="missing-media" role="note">Dieser Screenshot ist in der ursprünglichen Dokumentation nicht verfügbar.</span><figcaption></figcaption></figure>

***

### 🧩 Schritt 2/3 – Felder zuordnen&#x20;

<figure><img src="/media/5beb2e9d9f197c6c8f0e.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

**A) Zuordnung des Primärschlüssels**

Damit weiß die App, wie sie Zeilen Ihrer CSV-Datei mit Produkten in Shopify abgleicht.

* **Primärschlüssel (Primary Key)**: Wählen Sie, anhand wovon Ihr Shopify-Shop abgleicht\
  Beispiel: **Produkt-Handle**
* **Spaltenüberschrift (Column heading)**: Wählen Sie die Spalte in Ihrer CSV-Datei\
  Beispiel: **Handle**

> Wenn Ihr Primärschlüssel nicht übereinstimmt, erstellt die App möglicherweise Duplikate oder aktualisiert nicht das richtige Produkt.

**B) CSV-Spalten den Shopify-Feldern zuordnen**

Sie sehen Tabs wie:

* **Produkt**
* **Variante (Variant)**
* **Bild (Image)**
* **Metafeld (Metafield)**
* **Bestand**

Für jede Zeile:

* **In Shopify importieren (Import to Shopify)** = Shopify-Feld (z. B. Title)
* **Spaltenüberschrift** = CSV-Spalte (z. B. Title)

Mit **➕ Zuordnung hinzufügen (Add mapping)** können Sie weitere Felder importieren.

Klicken Sie anschließend auf **Nächster Schritt (Next Step)**.

***

### ⚙️ Schritt 3/3 – Import-Einstellungen&#x20;

<figure><img src="/media/0982d902faf55aaf2e59.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Schritt 3.1. Abgleich und Import (wie Shopify aktualisiert wird)**

Wählen Sie eine Option:

✅ **Neue Elemente erstellen (Create new items)**

* Erstellt nur neue Produkte (bestehende werden nicht aktualisiert)

✅ **Nur aktuelle Elemente mit demselben Primärschlüssel aktualisieren (Only update current items that have the same primary key)**

* Aktualisiert nur bestehende Produkte
* Erstellt KEINE neuen

✅ **Neue Elemente erstellen, falls nicht vorhanden, und aktuelle Elemente mit demselben Primärschlüssel aktualisieren (Create new items if not exist and update current items that have the same primary key)** *(häufigste Wahl)*

* Erstellt fehlende Produkte
* Aktualisiert bestehende Produkte, die übereinstimmen (per Handle/SKU usw.)

***

#### **Schritt 3.2. Upload-Umfang (wie viel importiert wird)**

* **Alles importieren (Import All)**: Importiert alles in der Datei
* **Import festlegen (Specify import)**: Importiert nur einen ausgewählten Zeilenbereich (nützlich zum Testen)

***

#### **Schritt 3.3. Daten filtern (optional)**

* **Nur Daten importieren, die … enthalten (Only import data containing …)** (Einschlussregel)
* **Daten ausschließen, die … enthalten (Exclude data containing …)** (Ausschlussregel)

Nutzen Sie das, wenn Sie nur bestimmte Zeilen importieren möchten (z. B. nur Zeilen, die `SYNC` enthalten).

***

#### **Schritt 3.4. Bilddaten (wenn Ihre CSV-Datei Bilder enthält)**

Wählen Sie eine Option:

* **Neue Bilder hinzufügen (Add new images)** (fügt Bilder hinzu, ohne alte zu entfernen)
* **Nur bei Produkterstellung (Upon creation product only)** (fügt Bilder nur für neue Produkte hinzu)
* **Aktuelle Bilder überschreiben (Overwrite current images)** (ersetzt vorhandene Bilder)

***

#### **Schritt 3.5. E-Mail-Benachrichtigungen (optional)**

Wählen Sie, wann Sie E-Mails erhalten möchten:

* Beim Start des Uploads
* Nach Abschluss des Uploads
* Bei einem Upload-Fehler

***

#### **Schritt 3.6. Upload planen**&#x20;

* **Jetzt ausführen (Run now)** (sofort importieren)\
  (Je nach Tarif/Einstellungen werden möglicherweise weitere Zeitplanoptionen angezeigt.)

Klicken Sie abschließend oben rechts auf **Speichern (Save)**.

***

## 🧪 Beispiel: Bestehende Produkte aktualisieren + neue erstellen

**CSV-Beispiel**

| Handle              | Title               | Vendor     |
| ------------------- | ------------------- | ---------- |
| ceramic-table-lamp  | Ceramic Table Lamp  | ModernHome |
| wooden-floor-mirror | Wooden Floor Mirror | ModernHome |

**Zu wählende Einstellungen**

* **Primärschlüssel**: Produkt-Handle
* **Spaltenüberschrift**: Handle
* **Abgleich und Import**: Neue Elemente erstellen, falls nicht vorhanden, und aktuelle Elemente mit demselben Primärschlüssel aktualisieren

**Ergebnis**

* Wenn `ceramic-table-lamp` bereits existiert → wird es aktualisiert
* Wenn `wooden-floor-mirror` nicht existiert → wird es erstellt

***

**🙋 Benötigen Sie weitere Hilfe?**

Wenn Sie weitere Hilfe benötigen, schreiben Sie uns gerne an <hi@tipo.io>. Wir unterstützen Sie gerne.
