Ratgeber
Produkte per CSV in Shopify importieren
Shopify kann viele Produkte auf einmal aus einer CSV-Datei anlegen oder aktualisieren. So funktioniert der Import, wo es knifflig wird und was zu tun ist, wenn Ihre Produktdaten in Lieferanten-PDFs stecken.
Der Produkt-CSV-Import von Shopify ist der Standardweg, um einen Katalog in großen Mengen anzulegen. Sie bereiten eine Tabelle im Shopify-Format vor, laden sie im Backend hoch, und Shopify legt Produkte, Varianten und Bilder an.
Wie bei jedem Import hängt der Erfolg von den Daten ab, die Sie hineingeben. Dieser Ratgeber behandelt den CSV-Prozess, die Alternativen und die Vorbereitung, die Ihnen die nachträgliche Bereinigung Hunderter Produkte erspart.
Option 1: Produkt-CSV im Shopify-Backend importieren
Gehen Sie im Shopify-Backend zu Produkte und wählen Sie Importieren. Laden Sie eine CSV im Shopify-Produktformat hoch, entscheiden Sie, ob Produkte mit übereinstimmenden Handles überschrieben werden sollen, sehen Sie sich die Vorschau an und bestätigen Sie. Shopify verarbeitet die Datei im Hintergrund und benachrichtigt Sie, wenn sie fertig ist.
- Beginnen Sie mit der Beispiel-CSV-Vorlage von Shopify oder exportieren Sie ein vorhandenes Produkt, um die genauen Spalten zu sehen.
- Die Spalte URL handle (in älteren Vorlagen Handle) identifiziert ein Produkt; Zeilen mit demselben Handle sind Varianten oder zusätzliche Bilder desselben Produkts.
- Gängige Spalten sind Title, Description (Body (HTML)), Vendor, Product category, Type, Tags, Status, Option1 name / Option1 value, SKU (Variant SKU), Price, Barcodes (Variant Barcode) und Product image URL (Image Src).
- Bilder werden beim Import von öffentlichen URLs abgerufen.
- Speichern Sie die Datei als UTF-8-CSV, damit Sonderzeichen erhalten bleiben.
Varianten richtig behandeln
Varianten bereiten bei den meisten ersten Importen Probleme. Jedes Produkt kann bis zu drei Optionen haben (zum Beispiel Größe, Farbe, Material). Die erste Zeile eines Produkts enthält die Felder auf Produktebene und die Optionsnamen; jede weitere Zeile mit demselben Handle fügt eine Variante mit ihren Optionswerten, SKU, Preis und Bestand hinzu.
Halten Sie die Optionsnamen in allen Zeilen identisch und die Kombination der Optionswerte jeder Variante eindeutig, damit jede Zeile genau einer Variante entspricht. Eine Zeile mit Variantenspalten, aber ohne Option1 name und Option1 value, veranlasst Shopify, eine Standardvariante anzulegen und die vorhandenen zu löschen.
Option 2: Bulk-Import-Apps
Import-Apps aus dem Shopify App Store erweitern die native CSV: Unterstützung für Excel und Google Sheets, Metafelder, zeitgesteuerte Importe aus Lieferanten-Feeds und die Migration von anderen Plattformen. Sie lohnen sich, wenn Sie wiederholt importieren oder Felder benötigen, die die Standard-CSV nicht abdeckt.
Option 3: Die Shopify Admin API
Apps und individuelle Integrationen können Produkte über die Admin API von Shopify anlegen, statt eine CSV-Datei zu verwenden. Das vermeidet Tabellen-Umwege vollständig und ist der Weg, über den viele Katalog- und Listing-Werkzeuge Produkte in Shopify anlegen.
Doc2Shelf nutzt diesen Weg: Sie verbinden Ihren Shop per OAuth, und geprüfte Listings werden als Produktentwürfe mit Bildern, Preisen und Kategorien angelegt.
Produktdaten für Shopify vorbereiten
Prüfen Sie vor jedem Massenupload, dass:
- jedes Produkt einen eindeutigen Handle und jede Variante eine eindeutige SKU hat.
- Titel einem einheitlichen Muster folgen (zum Beispiel Marke + Produkt + wichtigstes Attribut).
- Beschreibungen Ihre eigenen Texte sind, nicht eingefügter Lieferantentext, und einfaches HTML verwenden.
- Spezifikationen einheitliche Einheiten und Bezeichnungen haben, damit sie zu Optionen, Tags oder Metafeldern werden können.
- Produkte zunächst unveröffentlicht importiert werden, damit Sie eine Stichprobe prüfen können, bevor sie live gehen.
Wenn die Produktdaten aus Lieferanten-PDFs stammen
Ein CSV-Import setzt voraus, dass Sie bereits saubere, strukturierte Daten haben. Schicken Lieferanten Spezifikationsblätter und Kataloge als PDFs, muss zuerst jemand Titel, Spezifikationen und Kennungen extrahieren und Beschreibungen schreiben — meist der langsamste Teil der gesamten Arbeit.
Doc2Shelf ersetzt diesen Schritt: Es liest Lieferanten-PDFs, extrahiert die Produktdaten mit Konfidenzangaben zur Prüfung, entwirft die Shopify-Listing-Texte und legt geprüfte Produkte ohne CSV als Entwürfe in Ihrem verbundenen Shop an.
Spalten der Shopify-Produkt-CSV: aktuelle Namen und ältere Entsprechungen
Shopify hat mehrere Spalten der Produkt-CSV umbenannt. Die aktuelle CSV-Referenz verwendet Bezeichnungen wie URL handle, Description, SKU und Barcodes, während viele Vorlagen und Anleitungen noch Handle, Body (HTML), Variant SKU und Image Src zeigen. Laut Shopify bleibt die Abwärtskompatibilität mit älteren Spaltennamen erhalten, sodass eine ältere Datei weiterhin importiert wird — ein frischer Export verwendet aber die aktuellen Bezeichnungen, und eine Datei mit gemischten Stilen ist schwer zu prüfen.
Die Tabelle deckt die Spalten ab, die die meisten Massen-Uploads brauchen. Die Umbenennung von Barcode in Barcodes ist in der Shopify-Dokumentation belegt; die übrigen älteren Bezeichnungen sind nach dem Inhalt des jeweiligen Felds zugeordnet, bestätigen Sie sie daher anhand eines Exports aus Ihrem eigenen Shop. Bei Kopfzeilen wird zwischen Groß- und Kleinschreibung unterschieden.
| Aktuelle Spalte | Inhalt | Beispiel | Ältere Bezeichnung oder Hinweise |
|---|---|---|---|
| Title | Produktname | Wasserkocher aus Edelstahl 1,7 L | Zum Anlegen eines Produkts erforderlich. |
| URL handle | Eindeutige Produktkennung, die in der Produkt-URL verwendet wird | steel-kettle | Ältere Vorlagen bezeichnen sie als Handle. Zeilen mit demselben Handle gehören zu einem Produkt. |
| Description | Produktbeschreibung | Kabelloser Wasserkocher mit… | Ältere Vorlagen bezeichnen sie als Body (HTML). |
| Vendor | Marke oder Hersteller | Acme | — |
| Product category | Kategorie der Standard Product Taxonomy | hg-15-1-2 | Vollständiger Breadcrumb oder Kategorie-ID, nicht beides. |
| Type | Ihr eigener Produkttyp | Elektrischer Wasserkocher | Freitext, anders als die Kategorie. |
| Tags | Durch Kommas getrennte Tags | kabellos, Küche | Bis zu 250 Tags pro Produkt. |
| Status | Produktstatus | draft | Als Entwurf importieren, prüfen, dann aktivieren. |
| SKU | SKU der Variante | KTL-SLV | Ältere Vorlagen bezeichnen sie als Variant SKU. |
| Barcodes | Barcodes der Variante | gtin:4006381333931 | Früher Barcode (und davor Variant Barcode). Mehrere durch Semikolons trennen; das Typpräfix ist optional. |
| Option1 name / Option1 value | Erste Option und der Wert dieser Variante | Farbe / Silber | Option2 und Option3 folgen demselben Muster. |
| Option1 LinkedTo | Verknüpfung der Option mit einem Kategorie-Metafeld | product.metafields.shopify.[attribute] | Optional; siehe den Abschnitt zur Taxonomie weiter unten. |
| Price / Compare-at price | Verkaufspreis und Vergleichspreis | 49.90 / 59.90 | Spalten der Form Price / [Market] enthalten marktspezifische Preise. |
| Inventory quantity | Lagerbestand | 25 | Funktioniert zusammen mit der Spalte Inventory tracker. |
| Weight value (grams) | Variantengewicht in Gramm | 1200 | Ältere Vorlagen bezeichnen sie als Variant Grams. Weight unit for display legt die Einheit fest, die Käufer sehen. |
| Product image URL | Öffentliche URL eines Produktbilds | https://cdn.example.com/kettle.jpg | Ältere Vorlagen bezeichnen sie als Image Src. |
| Image position / Image alt text | Reihenfolge in der Galerie und Alternativtext | 1 / Wasserkocher aus Edelstahl, Vorderansicht | Alternativtext bis zu 512 Zeichen. |
| Variant image URL | Bild, das beim Auswählen dieser Variante angezeigt wird | https://cdn.example.com/kettle-black.jpg | — |
| SEO title / SEO description | Titel und Meta-Beschreibung für Suchergebnisse | — | Bis zu 70 bzw. 320 Zeichen. |
| Metafield columns | Werte der Produkt-Metafelder | Material (product.metafields.custom.material) | Kopfzeilenformat: Name (product.metafields.namespace.key). |
Varianten und Optionen: Limits und Fallstricke
Ein Shopify-Produkt kann bis zu drei Optionen haben — zum Beispiel Größe, Farbe und Material — und bis zu 2.048 Varianten. Das Variantenlimit lag bei 100, bis Shopify es im Oktober 2025 anhob; früher geschriebene Vorlagen und Anleitungen nennen daher noch die alte Zahl. Einige Themes, Apps und Vertriebskanäle wurden um das alte Limit herum gebaut, prüfen Sie Ihre daher, bevor Sie ein Produkt mit Hunderten Varianten importieren.
Die erste Zeile eines Produkts enthält die Felder auf Produktebene und die Optionsnamen. Jede folgende Zeile mit demselben URL handle fügt eine Variante mit Optionswert, SKU, Preis, Gewicht und Bestand hinzu und lässt die Felder auf Produktebene leer.
Zwei Verhaltensweisen überraschen bei Update-Importen. Enthält eine Zeile Variantenspalten wie SKU oder Gewicht, lässt aber Option1 name und Option1 value weg, legt Shopify eine Standardvariante an und löscht die vorhandenen Varianten. Und wer einen Optionswert ändert — etwa „Grau“ in „Hellgrau“ umbenennt —, löscht die Varianten-IDs und erzeugt neue, was Apps und Feeds beeinträchtigen kann, die auf diese IDs verweisen.
| Zeile | URL handle | Title | Option1 name | Option1 value | SKU |
|---|---|---|---|---|---|
| Erste Zeile | steel-kettle | Edelstahl-Wasserkocher | Farbe | Silber | KTL-SLV |
| Nächste Zeile | steel-kettle | (leer) | (leer) | Schwarz | KTL-BLK |
Produktbilder in einer Shopify-CSV
Shopify lädt Bilder beim Import aus der Spalte Product image URL herunter, daher muss jede URL öffentlich zugänglich sein und direkt auf die Bilddatei verweisen. Links, die eine Anmeldung erfordern, eine Vorschauseite öffnen oder ablaufen, bevor der Import läuft, sind die üblichen Gründe für fehlende Bilder.
Ein Produkt kann bis zu 250 Bilder oder andere Medien enthalten. Setzen Sie das erste Bild in die erste Zeile des Produkts; fügen Sie jedes weitere Bild in einer eigenen Zeile mit demselben URL handle, der Bild-URL, seiner Image position und seinem Image alt text hinzu. Damit ein bestimmtes Bild erscheint, wenn Käufer eine Variante wählen, tragen Sie seine URL in der Zeile dieser Variante unter Variant image URL ein.
Alternativtexte dürfen bis zu 512 Zeichen lang sein, Shopify empfiehlt höchstens 125. Beschreiben Sie, was das Bild zeigt — „Wasserkocher aus Edelstahl, Vorderansicht mit Wasserstandsanzeige“ —, statt den Produkttitel zu wiederholen.
Produktkategorie, Metafelder und die Standard Product Taxonomy
Die Spalte Product category weist eine Kategorie aus Shopifys Standard Product Taxonomy zu, die nach der Hauptfunktion des Produkts gewählt wird. Geben Sie entweder den vollständigen Breadcrumb ein, etwa Home & Garden > Linens & Bedding > Bedding > Bed Sheets, oder die Kategorie-ID, etwa hg-15-1-2 — nicht beides. Ein Produkt ohne Kategorie gilt als nicht kategorisiert.
Das Festlegen einer Kategorie schaltet deren Kategorie-Metafelder frei, die die Taxonomie Produktattribute nennt. Shopifys Kategorie „Shirts“ hat zum Beispiel neun, darunter Größe, Ausschnitt, Stoff und Farbe, und Farbwerte können als Farbfelder angezeigt werden. Die Spalte Option1 LinkedTo verbindet eine Variantenoption mit einem dieser Kategorie-Metafelder.
Die Kategorie ist nicht nur für die Navigation wichtig: Shopify Tax nutzt sie zur Festlegung der Steuersätze. Type dagegen ist eine frei wählbare Bezeichnung, die Sie selbst definieren und die für Ihre eigenen Filter und Berichte nützlich ist.
Benutzerdefinierte Produkt-Metafelder werden über Spalten mit der Kopfzeile Name (product.metafields.namespace.key) importiert, zum Beispiel Werkstoff (product.metafields.custom.material). Varianten-Metafelder werden in der Produkt-CSV nicht unterstützt; legen Sie diese im Backend, mit einer App oder über die API fest.
Shopify-CSV-Limits und Längen der SEO-Felder
Dies sind die Limits, die Shopify für Produkt-CSV-Importe und Produktdatensätze dokumentiert. Zahlen in älteren Ratgebern — insbesondere das Limit von 100 Varianten — sind veraltet.
Die Spalten SEO title und SEO description füllen den Titel und die Meta-Beschreibung, die in Suchergebnissen verwendet werden. Schreiben Sie sie pro Produkt, statt ein Muster über den ganzen Katalog zu kopieren: Beginnen Sie mit dem Produktnamen und dem Attribut, nach dem Käufer suchen, etwa Größe, Material oder Modellnummer.
| Element | Limit | Was zu tun ist |
|---|---|---|
| Größe der CSV-Datei | 15 MB | Große Kataloge aufteilen; alle Zeilen eines Produkts in einer Datei halten. |
| Optionen pro Produkt | 3 | Weitere Unterschiede als separate Produkte oder Metafelder abbilden. |
| Varianten pro Produkt | 2.048 | Prüfen, ob Ihr Theme und Ihre Apps große Variantenzahlen verarbeiten. |
| Bilder und Medien pro Produkt | 250 | Die Galerie auf Bilder beschränken, die Käufern bei der Entscheidung helfen. |
| Tags pro Produkt | 250 | Tags für Filterung und Automatisierung nutzen. |
| Barcodes pro Produkt oder Variante | 20 | Ein Typpräfix wie gtin: ergänzen, wo der Typ bekannt ist. |
| SEO-Titel | 70 Zeichen | Mit Produktname und Schlüsselattribut beginnen. |
| SEO-Beschreibung | 320 Zeichen | Das Produkt zusammenfassen, wichtige Angaben zuerst. |
| Alternativtext des Bilds | 512 Zeichen (höchstens 125 empfohlen) | Beschreiben, was das Bild zeigt. |
Überschreiben oder anlegen: Wie sich Updates verhalten
Zum Anlegen eines Produkts braucht die CSV nur einen Title; für Varianten ist zusätzlich der URL handle nötig. Zum Aktualisieren eines vorhandenen Produkts braucht Shopify den URL handle und den Title, und Sie legen beim Start des Imports fest, dass Produkte mit übereinstimmenden Handles überschrieben werden.
Betrachten Sie ein Überschreiben als maßgeblich für jede Spalte, die Sie aufnehmen. Am sichersten ist das Muster Export, Bearbeiten, Reimport: die zu ändernden Produkte exportieren, nur die zu ändernden Zellen bearbeiten, die Optionsspalten beibehalten und die bearbeitete Datei mit aktiviertem Überschreiben importieren. Eine von Grund auf neu erstellte, lückenhafte Datei löst leicht das oben beschriebene Löschen von Varianten aus.
Lesen Sie die Importvorschau, bevor Sie bestätigen, und testen Sie ein großes Update zuerst an einer Handvoll Produkte. Der Export, den Sie vor dem Bearbeiten erstellt haben, ist Ihr Weg zurück, falls etwas schiefgeht.
Checkliste vor dem Import und Fehlerbehebung
Gehen Sie diese Schritte vor einem großen Import durch; die Tabelle danach behandelt die häufigsten Probleme.
- Exportieren Sie ein Produkt aus Ihrem Shop und verwenden Sie dessen Kopfzeile wieder, damit die Spaltennamen exakt übereinstimmen.
- Geben Sie jedem Produkt einen eindeutigen URL handle und jeder Variante eine eindeutige SKU.
- Prüfen Sie Optionsnamen und -werte auf einheitliche Schreibweise und stellen Sie sicher, dass jede Variantenzeile ihren Optionswert hat.
- Füllen Sie Product category mit einem Breadcrumb oder einer aus der Taxonomie kopierten ID.
- Öffnen Sie eine Stichprobe von Bild-URLs in einem privaten Browserfenster, um zu bestätigen, dass sie ohne Anmeldung laden.
- Setzen Sie Status für den ersten Durchlauf auf draft.
- Speichern Sie als UTF-8-CSV und stellen Sie sicher, dass die Datei unter 15 MB liegt.
- Importieren Sie fünf bis zehn Produkte, prüfen Sie sie im Backend und im Shop und importieren Sie dann den Rest.
| Problem | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Datei abgelehnt | Größer als 15 MB oder nicht als UTF-8-CSV gespeichert | Datei nach Produkten aufteilen und erneut als UTF-8-CSV speichern |
| Spalte wird ignoriert | Kopfzeile falsch geschrieben oder anders groß-/kleingeschrieben | Kopfzeilen aus einem frischen Export kopieren |
| Varianten nach einem Update verschwunden | Variantenspalten ohne Option1 name und value übermittelt | Erneut importieren, diesmal mit den Optionsspalten |
| Apps haben Varianten aus den Augen verloren | Ein Optionswert wurde umbenannt, wodurch neue Varianten-IDs entstanden | Optionswerte bewusst umbenennen und betroffene Apps neu verbinden |
| Produkte falsch geteilt oder zusammengeführt | URL handle unterscheidet sich zwischen den Zeilen eines Produkts | Pro Produkt einen identischen Handle verwenden |
| Bilder fehlen | URL nicht öffentlich, kein direkter Dateilink oder abgelaufen | Bilder unter stabilen öffentlichen URLs hosten |
| Kategorie nicht gesetzt | Breadcrumb falsch getippt oder sowohl Breadcrumb als auch ID angegeben | Genau eines verwenden, aus der Taxonomie kopiert |
| Barcode nicht akzeptiert | Länge passt nicht zum angegebenen Typ | GTIN: 8, 12, 13 oder 14 Ziffern; UPC: 8 oder 12; EAN: 8 oder 13 |
| Metafeld-Werte fehlen | Falsches Kopfzeilenformat oder ein Varianten-Metafeld | Name (product.metafields.namespace.key) verwenden; Varianten-Metafelder anderweitig festlegen |
Häufig gestellte Fragen
- Wie kann ich Produkte kostenlos in großen Mengen zu Shopify hochladen?
- Nutzen Sie den integrierten CSV-Import unter Produkte → Importieren. Er ist in jedem Shopify-Tarif enthalten und verarbeitet Produkte, Varianten und Bilder aus einer CSV-Datei im Shopify-Format.
- Kann ich Produkte aus Excel zu Shopify hochladen?
- Der native Importer benötigt CSV. Speichern Sie Ihre Excel-Tabelle daher als UTF-8-CSV mit den Spaltennamen von Shopify. Einige Import-Apps können Excel-Dateien direkt lesen.
- Überschreibt ein CSV-Import meine vorhandenen Produkte?
- Vorhandene Produkte werden nur aktualisiert, wenn Sie die Option wählen, Produkte mit übereinstimmenden Handles zu überschreiben. Prüfen Sie die Importvorschau, bevor Sie bestätigen, und testen Sie zuerst mit einer kleinen Datei.
- Warum werden meine Bilder nicht importiert?
- Bild-URLs müssen öffentlich zugängliche, direkte Links auf Bilddateien sein. Links, die eine Anmeldung erfordern, auf eine Webseite weiterleiten oder von einer temporären Dateifreigabe stammen, schlagen meist fehl.
- Welche Spalten sind in einer Shopify-Produkt-CSV erforderlich?
- Zum Anlegen eines Produkts ist nur der Title erforderlich, bei Varianten zusätzlich das URL handle. Zum Aktualisieren bestehender Produkte geben Sie URL handle und Title an. Alles andere ist optional, wobei ein brauchbares Angebot in der Regel Preis, SKU, Kategorie, Beschreibung und Bilder benötigt.
- Wie viele Varianten kann ein Shopify-Produkt haben?
- Bis zu 2.048 Varianten bei maximal drei Optionen. Shopify hat das Limit im Oktober 2025 von 100 angehoben; ältere Vorlagen und Anleitungen, die 100 nennen, sind daher überholt.
- Kann ich Metafelder mit einer Shopify-CSV importieren?
- Produkt-Metafelder ja: Fügen Sie eine Spalte mit der Überschrift Name (product.metafields.namespace.key) hinzu. Varianten-Metafelder werden in der Produkt-CSV nicht unterstützt und müssen im Admin-Bereich, mit einer App oder über die API gesetzt werden.
- Wie groß darf eine Shopify-Produkt-CSV höchstens sein?
- Eine Produkt-CSV darf 15 MB nicht überschreiten. Teilen Sie größere Kataloge auf mehrere Dateien auf und lassen Sie alle Zeilen eines Produkts in derselben Datei.