Produkte per CSV in Shopify importieren: Umlaute und Varianten ohne Fehler
Kurz gesagt: Shopify erwartet eine CSV-Datei in UTF-8 mit Komma als Trennzeichen und Punkt als Dezimalzeichen. Ein deutsches Excel speichert dagegen gern mit Semikolon und in einer anderen Zeichenkodierung, daher der Zeichensalat bei „Größe“ oder „Bügel“. Varianten erkennt Shopify ausschließlich an der Spalte Handle: Alle Zeilen eines Produkts tragen denselben Handle, nur die erste Zeile enthält Titel und Beschreibung. Starten Sie mit der Musterdatei von Shopify, testen Sie mit fünf Produkten und lesen Sie die Fehlermeldung, bevor Sie die ganze Liste hochladen.
Die Musterdatei als Ausgangspunkt
Bauen Sie Ihre Tabelle nicht frei, sondern laden Sie die Beispiel-CSV aus der Shopify-Hilfe zum CSV-Import herunter. Die Spaltennamen müssen exakt stimmen, auch in englischer Schreibweise. „Preis“ statt Variant Price wird schlicht ignoriert. Kopieren Sie Ihre Daten Spalte für Spalte in diese Vorlage, statt die Spaltenköpfe in Ihre eigene Liste zu übertragen.
Umlaute: UTF-8 richtig aus Excel speichern
Das häufigste Problem bei deutschsprachigen Shops: „Grüner Tee“ erscheint nach dem Import als „Grüner Tee“. Ursache ist eine falsche Zeichenkodierung.
In Excel unter Windows
- Datei öffnen, Speichern unter wählen.
- Als Dateityp CSV UTF-8 (durch Trennzeichen getrennt) auswählen, nicht das einfache „CSV (Trennzeichen-getrennt)“.
- Speichern und die Datei mit einem Texteditor öffnen. Stehen dort Semikolons zwischen den Werten, ist das Trennzeichen falsch.
Das Semikolon-Problem
Excel richtet sich bei CSV nach den Ländereinstellungen von Windows. In Deutschland und Österreich ist das Listentrennzeichen meist ein Semikolon, weil das Komma als Dezimalzeichen dient. Shopify erwartet aber Kommas. Drei Auswege:
- Google Tabellen: Datei dort importieren und über Datei, Herunterladen, Kommagetrennte Werte exportieren. Das Ergebnis ist UTF-8 mit Komma.
- LibreOffice Calc: Beim Speichern als CSV „Filtereinstellungen bearbeiten“ anhaken, Zeichensatz Unicode (UTF-8), Feldtrennzeichen Komma.
- Excel-Einstellung ändern: In den erweiterten Optionen das Systemtrennzeichen umstellen. Das wirkt sich aber auf alle Tabellen aus und ist im Büroalltag oft unpraktisch.
Dezimalzahlen
Preise wie 24,90 interpretiert Shopify nicht korrekt. Schreiben Sie 24.90. In Google Tabellen hilft vor dem Export ein Wechsel der Gebietsschema-Einstellung auf „Vereinigte Staaten“, dann werden Zahlen mit Punkt ausgegeben. Prüfen Sie danach Gewichte und Vergleichspreise auf dieselbe Weise.
Varianten: der Handle hält alles zusammen
Der Handle ist die technische Kennung eines Produkts, zugleich das Ende der Produkt-URL. Shopify fasst alle Zeilen mit gleichem Handle zu einem Produkt zusammen.
Beispiel für ein T-Shirt mit zwei Größen und zwei Farben:
| Handle | Title | Option1 Name | Option1 Value | Option2 Name | Option2 Value | Variant SKU | Variant Price |
|---|---|---|---|---|---|---|---|
| bio-shirt-basic | Bio-Shirt Basic | Größe | S | Farbe | Weiß | BSB-S-W | 29.00 |
| bio-shirt-basic | S | Schwarz | BSB-S-S | 29.00 | |||
| bio-shirt-basic | M | Weiß | BSB-M-W | 29.00 | |||
| bio-shirt-basic | M | Schwarz | BSB-M-S | 29.00 |
Darauf kommt es an:
- Titel, Beschreibung, Hersteller, Tags nur in der ersten Zeile.
- Optionsnamen wie „Größe“ und „Farbe“ ebenfalls nur in der ersten Zeile.
- Optionswerte, SKU, Preis, Barcode in jeder Zeile.
- Handles ohne Umlaute und Leerzeichen:
gruener-teestattgrüner tee. Shopify würde sonst eigene Handles erzeugen, und die Varianten landen als getrennte Produkte. - Keine doppelten Kombinationen: Zwei Zeilen mit „M, Weiß“ führen zu einem Fehler.
Häufiger Fehler aus der Praxis: Jemand füllt in Excel den Titel per Doppelklick in alle Zeilen. Das allein ist meist unkritisch, aber wenn die Handles leicht abweichen, etwa durch ein Leerzeichen am Ende, entstehen vier einzelne Produkte. Prüfen Sie Handles mit der Funktion GLÄTTEN in Excel oder TRIM in Google Tabellen.
Pflichtspalten und sinnvolle Ergänzungen
Unbedingt nötig sind Handle und Title. Für einen brauchbaren Import füllen Sie zusätzlich:
Body (HTML)mit der Beschreibung, gern mit einfachen Absätzen in<p>-TagsVendorfür Marke oder HerstellerVariant Priceund, falls vorhanden,Variant Compare At PriceVariant SKUundVariant BarcodeVariant Gramsoder Gewichtsspalten für die VersandberechnungStatusmitactiveoderdraft
Ein Tipp: Setzen Sie beim ersten Import alle Produkte auf draft. So sehen Kunden nichts, bis Sie die Ergebnisse kontrolliert haben.
Lagerbestände werden je nach aktuellem Vorlagenformat über eine eigene Bestands-CSV gepflegt. Prüfen Sie in der Hilfe, welche Spalten Ihre Vorlage enthält.
Bilder-URLs
Shopify lädt Bilder beim Import von einer öffentlich erreichbaren Adresse herunter.
- Die URL muss ohne Anmeldung im Browser öffnen, also kein Link in einen privaten Cloud-Ordner.
- Mehrere Bilder pro Produkt: weitere Zeilen mit demselben Handle und nur
Image SrcsowieImage Positionausfüllen. - Variantenbilder: die Bild-URL in
Variant Imageder jeweiligen Zeile. - Dateinamen ohne Umlaute und Leerzeichen, also
gruener-tee-100g.jpg.
Wenn Ihre Bilder nur lokal liegen, laden Sie sie zuerst unter Content, Dateien hoch und kopieren die dort erzeugten Links in die CSV.
Testimport mit fünf Produkten
- Kopieren Sie fünf typische Produkte in eine eigene Datei: eines ohne Varianten, eines mit Größen, eines mit Größe und Farbe, eines mit mehreren Bildern, eines mit Umlauten im Titel.
- Importieren Sie unter Produkte, Importieren.
- Lesen Sie die Vorschau, die Shopify vor dem Import zeigt, besonders die Zahl der erkannten Produkte und Varianten.
- Prüfen Sie nach dem Import jedes Produkt im Admin und im Shop.
- Erst wenn alles stimmt, laden Sie die vollständige Liste hoch.
Den Fehlerbericht lesen
Bricht der Import ab, nennt Shopify Zeile und Ursache. Häufige Meldungen und ihre Bedeutung:
- Ungültige Kodierung: Datei nicht in UTF-8 gespeichert.
- Fehlende Spalte oder unbekannter Kopf: Spaltenname weicht von der Vorlage ab.
- Doppelte Optionswerte: zwei Varianten mit identischer Kombination.
- Bild konnte nicht geladen werden: URL nicht öffentlich oder falsch geschrieben.
Bei sehr großen Dateien teilen Sie die Liste in mehrere Teile auf, denn Shopify begrenzt die Dateigröße pro Import.
Häufige Fragen
Überschreibt ein erneuter Import bestehende Produkte?
Nur wenn Sie die Option zum Überschreiben gleicher Handles aktivieren. Ohne diese Option werden bestehende Handles übersprungen.
Warum sind aus einem Produkt vier geworden?
Fast immer unterscheiden sich die Handles minimal, etwa durch Großbuchstaben, Umlaute oder Leerzeichen.
Lässt sich die Datei direkt aus unserer Warenwirtschaft exportieren?
Ja, wenn der Export UTF-8 mit Komma liefert und Sie die Spalten auf die Shopify-Namen umbenennen. Ein kleiner Umwandlungsschritt in Google Tabellen genügt oft.
Haben Sie eine große Produktliste aus der Warenwirtschaft und wollen den Import einmal sauber automatisieren, übernehmen wir die Aufbereitung: Daten schicken und anfragen.