Shopify-CSV importieren, ohne den Katalog zu beschädigen

Das Shopify-CSV ist zugleich die beste und die schlechteste Methode, einen Katalog zu verwalten. Beste: Es ist das native, offizielle Format, mit dem Sie 10.000 Produkte in einem Durchgang bearbeiten können. Schlechteste: Ein schlecht strukturiertes CSV kann Ihren Katalog in 3 Minuten duplizieren, überschreiben oder löschen, ohne Rückfrage.

Hier finden Sie die genaue Struktur, die 6 Spalten, die Sie niemals massenhaft ändern sollten, und das Rollback-Verfahren, um bei Problemen schnell wiederherzustellen.

Die Struktur eines nativen Shopify-CSV

Exportieren Sie ein Produkt aus Ihrem Shopify-Admin (Products → Export), um die offizielle Struktur zu sehen. Die wichtigsten Spalten:

Spalte	Funktion	In bulk änderbar?
`Handle`	Eindeutige Kennung (= URL-Slug)	⚠️ Niemals
`Title`	Produktname	✅ Ja
`Body (HTML)`	Beschreibung	✅ Ja
`Vendor`	Marke/Lieferant	✅ Ja
`Type`	Produkttyp	✅ Ja
`Tags`	Tags (durch Komma getrennt)	✅ Ja, mit Vorsicht
`Published`	Veröffentlicht ja/nein (`TRUE`/`FALSE`)	✅ Ja
`Option1 Name`, `Option1 Value`	Name + Wert der ersten Variante	⚠️ Niemals
`Option2 Name`, `Option2 Value`	Zweite Variante	⚠️ Niemals
`Option3 Name`, `Option3 Value`	Dritte Variante	⚠️ Niemals
`Variant SKU`	SKU-Code der Variante	⚠️ Niemals
`Variant Price`	Preis der Variante	✅ Ja
`Variant Compare At Price`	Streichpreis (alter Preis)	✅ Ja
`Variant Inventory Qty`	Lagerbestand	✅ Ja
`Image Src`	Bild-URL	✅ Ja
`Image Alt Text`	Alt-Text des Bildes	✅ Ja
`SEO Title`	SEO-Titel	✅ Ja
`SEO Description`	Meta Description	✅ Ja
`Status`	`active`/`archived`/`draft`	✅ Ja, mit Vorsicht

Jede Zeile = eine SKU, nicht ein Produkt. Ein Produkt mit 3 Varianten = 3 Zeilen mit demselben Handle.

Die 6 Spalten, die Sie niemals massenhaft ändern sollten

Diese Spalten sind die Integritätsschlüssel Ihres Katalogs. Wenn Sie sie unbedacht ändern, beschädigen Sie das Ganze:

`Handle`

Der Handle erzeugt die öffentliche URL des Produkts. Wenn Sie einen Handle ändern:

Ändert sich die Produkt-URL (/products/chaussure-derby → /products/chaussure-derby-v2)
Alle externen Backlinks brechen
Interne Links brechen (transaktionale E-Mails, Menüs, Google Shopping Ads)
Bereits aufgebautes SEO-Ranking geht verloren

Regel: Ändern Sie niemals einen bestehenden Handle. Nur bei der Erstellung neuer Produkte.

`Variant SKU`

Die SKU ist der Identifikationsschlüssel der Varianten in Ihrem Lager, Ihrem WMS und Ihren Analyse-Tools. Wenn Sie sie ändern:

Gerät Ihr Bestand durcheinander, wenn Sie ein externes System nutzen (ERP, WMS)
Brechen Integrationen (Fulfillment-Provider, Dropshipping-Lieferanten)
Können doppelte Varianten entstehen, wenn Shopify das Original nicht mehr erkennt

Regel: Bearbeiten Sie SKU nur Produkt für Produkt, niemals per bulk CSV.

`Option1 Name`, `Option2 Name`, `Option3 Name`

Die Optionsnamen definieren die Struktur der Varianten. Wenn Sie sie nach der Erstellung ändern:

Werden bestehende Varianten ungültig (das Produkt mit Option1 Name = Taille wird zu Option1 Name = Size, wodurch neue Optionen entstehen)
Entstehen stille Duplikate
Kann die Anzahl Ihrer Varianten explodieren (von 20 auf 200 in wenigen Sekunden)

Regel: Optionsnamen werden bei der Produkterstellung festgelegt, Punkt. Wenn Sie sie ändern müssen, tun Sie das in der Admin-Oberfläche Produkt für Produkt.

Das CSV vorbereiten: die 5 Checks vor dem Upload

Prüfen Sie vor jedem Import:

Check 1 — UTF-8-Encoding

Öffnen Sie das CSV in einem Texteditor (VS Code, Notepad++). Prüfen Sie, ob Umlaute und Sonderzeichen korrekt angezeigt werden. Wenn Sie fehlerhafte Zeichen sehen, ist das CSV in latin1 oder windows-1252 gespeichert. Dann müssen Sie es erneut in UTF-8 konvertieren.

Excel speichert standardmäßig in latin1 — vermeiden Sie Excel zum Bearbeiten eines CSV für Shopify. Nutzen Sie LibreOffice Calc, Google Sheets oder VS Code.

Check 2 — Komma als Trennzeichen

Das Shopify-CSV verwendet das Komma als Trennzeichen. In deutschsprachigen Locale-Einstellungen nutzt Excel standardmäßig oft das Semikolon. Wenn Sie beim Öffnen alle Daten in nur einer Spalte sehen, ist das Trennzeichen falsch.

Check 3 — Escaping von Kommas in Feldern

Wenn eine Beschreibung ein Komma enthält (sehr häufig), muss das Feld in Anführungszeichen stehen:

Handle,Title,Body (HTML)
derby-cuir,"Chaussure Derby en cuir","Élégante, confortable, fabriquée en France"

Ohne Anführungszeichen würde das Komma in "Élégante, confortable" als neues Feld interpretiert und alles verschieben.

Check 4 — Doppelte Zeilen

Ein Handle, der 2-mal im CSV vorkommt = Shopify behandelt die zweite Zeile als Variante, nicht als neues Produkt. Das kann zu Überraschungen führen.

In Google Sheets oder Excel können Sie Data → Remove duplicates verwenden, um zu bereinigen.

Check 5 — Sonderzeichen in Bild-URLs

Image Src muss eine öffentliche URL sein, die ohne Authentifizierung erreichbar ist. Testen Sie 3-5 zufällige URLs mit curl -I https://cdn.example.com/image.jpg — Status 200 ist Pflicht. Wenn Ihre URLs Leerzeichen oder Sonderzeichen enthalten, URL-encoden Sie diese (%20 für Leerzeichen).

Varianten verwalten, ohne zu duplizieren

Ein Produkt mit 3 Varianten wird in 3 CSV-Zeilen beschrieben:

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price
derby-cuir,Derby Cuir,Taille,42,DERBY-BLK-42,149.00
derby-cuir,,,,,
derby-cuir,,,,,

Zeile 1: vollständiges Produkt mit Title und Option1 Name Zeilen 2-3: NUR der Handle und die Variantenwerte (Option1 Value, SKU, Price usw.). Wiederholen Sie nicht Title, Body, Vendor usw. — sonst betrachtet Shopify sie als Änderungen und kann duplizieren.

Das ist die native Shopify-CSV-Syntax. Sie überrascht am Anfang, ist aber strikt.

Bilder: Drive vs CDN vs Shopify Files

Drei Optionen für Bild-URLs:

Option 1 — Google Drive

❌ Funktioniert nicht für Shopify. Drive liefert eine HTML-Seite zurück, kein direktes Bild. Shopify scheitert still.

Option 2 — Öffentliches CDN (Cloudflare Images, Amazon S3 + CloudFront, Bunny CDN)

✅ Empfohlen für große Importe. Die Bilder werden außerhalb von Shopify gehostet, Shopify lädt sie dann beim Import herunter.

Typische Kosten: 1-5 € pro Monat für 1000 Bilder in einem CDN.

Option 3 — Shopify Files

✅ Manueller Upload der Bilder in Content → Files in Shopify, danach Nutzung der Shopify-URLs im CSV. Geeignet für kleine Kataloge (<500 Bilder).

Grenze: Der Upload in Shopify Files ist manuell, nicht skriptbar für 10.000 Bilder.

Empfehlung: Öffentliches CDN für den ersten Import, danach hostet Shopify die Bilder nach dem Import automatisch.

Rollback vor der Veröffentlichung

Shopify bietet kein natives Rollback für einen fehlgeschlagenen CSV-Import. Sie können aber vorab ein Rollback vorbereiten:

Schritt 1 — Export vor dem Import

Exportieren Sie direkt vor dem Import Ihren vollständigen Katalog (Products → Export → CSV file for Excel, Numbers, or other spreadsheet programs). Speichern Sie diesen Export mit Datum im Dateinamen (catalog-2026-04-23-avant-import.csv).

Schritt 2 — Import mit Veröffentlichung im Draft-Modus

Ändern Sie Ihr CSV so, dass Published = FALSE oder Status = draft für alle importierten Produkte gilt. Die Produkte werden erstellt, sind im Store aber unsichtbar.

Schritt 3 — Manuelle Prüfung

Gehen Sie im Admin 20 zufällig importierte Produkte durch. Prüfen Sie:

Bilder korrekt geladen
Varianten in Ordnung
Preis korrekt
Beschreibung sauber

Schritt 4 — Veröffentlichung in Batches

Wenn alles korrekt ist, veröffentlichen Sie. Wenn ein Problem erkannt wird, müssen Sie nur die Draft-Produkte löschen, das Sicherungs-CSV erneut importieren und neu starten.

Bei größerem Schaden

Wenn der Import Ihren aktiven Katalog überschrieben hat, ohne den Draft-Modus zu nutzen:

Importieren Sie sofort Ihr Sicherungs-CSV erneut — es überschreibt den aktuellen Zustand
URLs und Reviews bleiben erhalten (Shopify identifiziert sie über den Handle)
Rechnen Sie mit 1-2 Stunden, bis Google erneut crawlt und neu rankt

Alternativen zum nativen CSV: wann ein spezialisiertes Tool sinnvoll ist

Das native CSV ist leistungsfähig, aber schwerfällig. Für regelmäßige Vorgänge mit >1000 Produkten:

Matrixify (früher Excelify): am vollständigsten, verwaltet komplexe Beziehungen, ca. 20 $/Monat
Shopify Flow: interne Shopify-Automatisierung, ideal für Trigger (niedriger Bestand, Tag usw.)
Ecomptimize: optimiert Beschreibungen, Metas, SEO für den gesamten Katalog; die Quelldatei bleibt 30 Tage herunterladbar, um bei Problemen erneut zu importieren

Für das massenhafte Umschreiben von Beschreibungen mit Qualitätskontrolle ist ein spezialisiertes Tool dem CSV klar überlegen. Siehe Ecomptimize für Shopify.

FAQ

Kann man ein CSV teilweise importieren (zum Beispiel nur Preise)?

Ja. Sie exportieren alles, behalten nur die Spalten Handle + Variant SKU + die zu ändernden Spalten und löschen die übrigen Spalten aus dem CSV. Shopify gleicht über SKU ab und ändert nur die vorhandenen Spalten.

Wie viele Zeilen kann ein CSV haben?

Technisch unbegrenzt, praktisch empfiehlt Shopify <50.000 Zeilen pro Datei. Darüber hinaus sollten Sie in mehrere Dateien aufteilen, jeweils mit einem eindeutigen Handle pro Produkt.

Überschreibt der Shopify-Import bestehende Bilder?

Wenn Ihr CSV eine Spalte Image Src mit einer anderen URL als der bestehenden enthält, ja — Shopify lädt das neue Bild herunter und ersetzt es. Wenn Sie Bilder nicht ändern möchten, löschen Sie die Spalten Image Src und Image Alt Text aus dem CSV.

Shopify-CSV importieren, ohne den Katalog zu beschädigen