Shopify-Produkt-CSV-Fehler: ungültiger Header und übersprungene Zeilen

Die Produkt-CSV von Shopify ist auf eine besondere Art unbarmherzig: Sie nimmt die Datei an, meldet den Import als abgeschlossen und lässt Sie mit Produkten ohne Varianten, Preisen auf null oder dem halben fehlenden Katalog zurück. Die Fehler, die sie doch meldet, sind knapp.

Hier ist, was jeder davon bedeutet.

„Invalid header" — ein nicht erkannter Spaltenname

Shopify erkennt Spalten am exakten Text ihrer Überschrift. Variant price, variant_price und Price sind alle falsch; die Spalte heißt Variant Price. Groß- und Kleinschreibung sowie Leerzeichen zählen.

Die Lösung. Exportieren Sie ein vorhandenes Produkt über Produkte → Exportieren und nutzen Sie die Kopfzeile dieser Datei als Vorlage. Das ist immer der aktuelle, korrekte Satz Namen für Ihren Shop.

Das Handle verbindet die Variantenzeilen

URL handle ist der URL-Slug des Produkts: Kleinbuchstaben, Ziffern und Bindestriche. Lassen Sie es bei einem neuen Produkt weg, leitet Shopify es aus dem Title ab — ein leeres Handle lässt also keine Produkte verschwinden.

Entscheidend ist es bei Varianten. Jede Variantenzeile muss dasselbe Handle wie ihr Elternprodukt wiederholen, denn nur das verbindet sie. Eine Variantenzeile mit leerem oder falsch geschriebenem Handle wird ein eigenes Produkt — die tatsächliche Ursache für „das Produkt ist da, aber jede Größe ist ein eigener Artikel".

Und wenn Sie bestehende Produkte aktualisieren statt neue anzulegen, ist Shopifys Dokumentation eindeutig: URL handle und Title sind die erforderlichen Spalten.

Varianten werden nicht angelegt oder zu einem Produkt verschmolzen

Das ist der Teil des Formats, über den fast alle stolpern. Varianten sind keine Spalten — sie sind zusätzliche Zeilen.

Ein Produkt mit drei Größen belegt vier Zeilen in der Datei:

• Zeile 1 trägt das vollständige Produkt: Handle, Title, Body (HTML), Vendor, Type, Tags, dazu Option1 Name (Größe), Option1 Value (S) sowie Preis und SKU dieser Variante.
• Zeilen 2–4 wiederholen denselben Handle, lassen Title und alle weiteren Produktspalten leer und füllen nur Option1 Value (M, L) mit eigenem Preis, SKU und Bestand.

Zwei Fehlerbilder folgen daraus, wenn man es falsch macht:

• Wiederholen Sie den Title in jeder Zeile, behandelt Shopify jede als eigenes Produkt.
• Füllen Sie Option1 Value, lassen aber Option1 Name in der ersten Zeile leer, werden die Optionen komplett ignoriert.

Preise als 0 importiert oder abgelehnt

Variant Price und Variant Compare At Price müssen reine Zahlen mit Punkt als Dezimaltrennzeichen sein. Kein Währungssymbol, kein Tausendertrennzeichen, kein Leerzeichen.

1.299,00 € schlägt fehl. 1299.00 funktioniert.

Das ist ein systematisches Problem bei Exporten aus europäischen Tools, wo 1.299,00 die normale Schreibweise ist — und Excel wendet dieses Format bei jedem Öffnen bereitwillig erneut an.

Die Lösung. Formatieren Sie die Preisspalte als Text und schreiben Sie den Rohwert, oder wandeln Sie beim Export um. Achtung: Die Anzeige in Excel umzuformatieren reicht nicht — entscheidend ist, was in der gespeicherten CSV landet.

Zerstörte Umlaute

Die Datei muss UTF-8 sein. Eine aus einem deutschen Excel gespeicherte CSV ist Windows-1252, Café kommt also als Café an.

Die Lösung. Speichern unter → CSV UTF-8 (durch Trennzeichen getrennt) — der eigene Eintrag in Excels Formatliste. Das schlichte CSV tut es nicht.

Bilder werden nicht importiert

Image Src muss eine vollständige, öffentlich erreichbare URL sein — https://…, kein lokaler Pfad und kein Link hinter einem Login. Shopify lädt jedes Bild beim Import herunter; was nicht abrufbar ist, wird stillschweigend übersprungen.

Für ein Produkt mit mehreren Bildern fügen Sie zusätzliche Zeilen mit demselben Handle an und füllen nur Image Src und Image Position.

Weiteres Wissenswertes

• Published nimmt TRUE oder FALSE; Status nimmt active, draft oder archived.
• Variant SKU sollte im gesamten Shop eindeutig sein — Duplikate machen die Bestandsführung unvorhersehbar.
• Ein bereits vorhandener Handle aktualisiert dieses Produkt, statt ein neues anzulegen. Absichtlich sehr nützlich, versehentlich zerstörerisch.

Checkliste vor dem Import

• Kopfzeile aus einem echten Shopify-Export übernommen
• URL handle angegeben, wenn Sie bestehende Produkte aktualisieren (für neue leitet Shopify es ab)
• Variantenzeilen wiederholen den Handle und lassen Produktspalten leer
• Option1 Name in der ersten Zeile jedes Produkts gefüllt
• Preise als reine Zahlen mit Punkt als Dezimaltrennzeichen
• Datei als CSV UTF-8 gespeichert
• Bild-URLs öffentlich und absolut

Wenn es jede Woche dieselbe Lieferantendatei ist

Das einmal von Hand aufzubauen, für eine Katalogmigration, ist ein vertretbarer Nachmittag.

Es jede Woche für eine Lieferanten-Preisliste zu tun, nicht. Importly nimmt den Rohexport, benennt die Spalten auf Shopifys Namen um (Title, Variant SKU, Variant Price, Variant Grams, Image Src…), entfernt Währungssymbole und wandelt Dezimaltrennzeichen, normalisiert Gewichte, Mengen und Barcodes, korrigiert die Codierung und löscht Leerzeilen. Als Profil gespeichert, durchläuft die Datei der nächsten Woche dieselben Regeln — Handle und Variantenzeilen bleiben Ihre Sache, denn Importly bereinigt Spaltennamen und Werte und baut die Zeilenstruktur nicht um.

Ersten Export kostenlos bereinigen →