1. Handle, Option und Variante: der Aufbau, den Shopify erwartet
Ein Hemd wird in den Grössen S, M und L geführt, dazu in den Farben Blau und Weiss. Sechs Varianten also – aber in Shopify entstehen sie nicht automatisch aus sechs beliebigen Zeilen einer Importdatei, sondern nur, wenn drei Konzepte korrekt zusammenspielen: Handle, Option und Variante.
Der Handle ist der Schlüssel, über den Shopify Zeilen zu einem gemeinsamen Produkt zusammenfasst. Alle Zeilen mit identischem Handle gelten als ein Produkt mit mehreren Varianten. Weicht der Handle auch nur in einer Zeile ab, entsteht daraus ein eigenständiges, separates Produkt – unabhängig davon, wie ähnlich Titel oder Beschreibung sind.
Eine Option ist die Dimension, über die sich Varianten voneinander unterscheiden – bei unserem Hemd also Grösse und Farbe. In der Importdatei wird sie über die Spalten Option1 Name und Option1 Value gesetzt, bei Bedarf ergänzt um Option2 Name/Option2 Value und Option3 Name/Option3 Value. Shopify erlaubt maximal drei Optionen pro Produkt – Material als viertes eigenständiges Merkmal ist damit nativ nicht mehr abbildbar, dazu mehr in Abschnitt 6.
Eine Variante schliesslich ist eine konkrete Kombination aus Optionswerten – Grösse M in Blau zum Beispiel – mit eigener Variant SKU und eigenem Variant Price. Wie viele solcher Kombinationen ein Produkt haben darf, ist eine andere Grenze als die Anzahl der Optionen, und genau diese beiden Grenzen werden häufig verwechselt: Seit dem 15. Oktober 2025 sind laut Shopifys Änderungsprotokoll bis zu 2048 Varianten pro Produkt möglich, zuvor waren es 100. Die Anzahl der Optionen selbst – also wie viele Merkmale ein Produkt unterscheiden darf – ist davon unberührt geblieben und liegt weiterhin bei drei.
| Begriff | CSV-Feld | Wofür es da ist |
|---|---|---|
| Produkt | Handle, Title | Fasst alle Zeilen mit identischem Handle zu einem Produkt zusammen. Der Handle bestimmt auch die URL der Produktseite. |
| Option | Option1 Name/Value bis Option3 | Definiert eine Dimension, über die sich Varianten unterscheiden (z. B. Grösse, Farbe). Maximal 3 Optionen pro Produkt. |
| Variante | eine Zeile mit eindeutiger Options-Kombination | Eine konkrete, verkaufbare Ausprägung mit eigener Variant SKU und Variant Price. Bis zu 2048 pro Produkt (seit 15.10.2025). |
Diese Unterscheidung – Handle gruppiert, Option definiert die Dimension, Variante ist die konkrete Ausprägung – ist der Ausgangspunkt für alles Weitere in diesem Beitrag. Wer Lieferantendaten manuell oder automatisiert für Shopify aufbereitet, sollte diese drei Begriffe klar auseinanderhalten, bevor überhaupt eine Importdatei entsteht: Jede Verwechslung an dieser Stelle setzt sich sonst durch den gesamten weiteren Ableitungsprozess fort.
2. Wie Lieferanten Varianten liefern
Shopify erwartet Zeilen mit gemeinsamem Handle und sauber getrennten Options-Spalten. Lieferantendaten liefern das fast nie in dieser Form, weil sie für die menschliche Lektüre entstanden sind, nicht für den Import. Vier Formen tauchen dabei immer wieder auf.
Eine Zeile pro Variante, Grösse in eigener Spalte. Eine Preisliste führt jede Grösse-Farbe-Kombination des Hemds als eigene Zeile mit eigener Artikelnummer. Diese Form ist am dankbarsten: Jede Zeile entspricht bereits fast einer Variantenzeile, es fehlt im Wesentlichen ein durchgängiger, identischer Handle für alle sechs Zeilen sowie die korrekte Verteilung der Werte auf Option1 Value und Option2 Value.
Eine Zeile pro Artikel, Grössen als Spalten nebeneinander. Andere Lieferanten liefern eine Zeile pro Farbe, mit separaten Spalten für S, M und L, in denen jeweils der Bestand steht. Diese Form muss zunächst „entpivotiert” werden: Aus einer Zeile mit drei Bestandsspalten werden drei Zeilen mit je einem Grössenwert, bevor daraus Optionswerte abgeleitet werden können.
Varianten stecken im Produktnamen. Häufig taucht die Variantenangabe nicht in einer eigenen Spalte auf, sondern im Freitext, etwa „Hemd Classic blau M”. Grösse und Farbe müssen hier zunächst aus dem Namen herausgelöst werden. Bei uneinheitlicher Schreibweise – „blau” versus „Blau” – ist zusätzlich eine Vereinheitlichung nötig, sonst entstehen versehentlich mehrere unterschiedliche Optionswerte für dieselbe Farbe.
Grössentabelle in einem separaten Abschnitt des Dokuments. In Katalog-PDFs steht die Grössenverfügbarkeit teilweise in einer eigenen Tabelle, getrennt vom Artikeltext, und lässt sich nur über die Artikelnummer der jeweiligen Seite zuordnen. Hier müssen zwei Bereiche eines Dokuments korrekt miteinander verknüpft werden, bevor überhaupt eine Zeile pro Variante entsteht.
In allen vier Fällen liegt die eigentliche Arbeit nicht im Import selbst, sondern im Schritt davor: aus uneinheitlichen Rohdaten einen durchgängigen Handle sowie saubere, konsistente Options-Spalten abzuleiten. Oft treten mehrere dieser Formen sogar innerhalb desselben Lieferantensortiments gemischt auf, etwa wenn ein Lieferant für Basisartikel eine Zeile pro Variante liefert, für Sonderaktionen aber eine abweichende, kompaktere Tabelle verwendet.
3. Was Shopify daraus braucht
Unabhängig vom Ausgangsformat läuft die Ableitung auf dasselbe Ziel hinaus: Zeilen mit identischem Handle, konsistent befüllten Option-Spalten und je Variante einer eigenen Variant SKU.
Lieferantendaten (Rohformat)
Zeile aus einer Preisliste: Artikelnummer „HEMD-CL-BL-M”, Bezeichnung „Hemd Classic blau M”, Bestand „12”.
Kein gemeinsamer Bezug zwischen den sechs Grössen-Farb-Kombinationen, Grösse und Farbe stehen im Freitext.
Für Shopify abgeleitete Struktur
Alle sechs Varianten teilen sich Handle „hemd-classic” und Title „Hemd Classic”.
Jede Zeile trägt eigene Werte in Option1 Value (Farbe), Option2 Value (Grösse) sowie eigene Variant SKU und Variant Price.
Wie ein entsprechender Ausschnitt aussehen könnte, zeigt die folgende, bewusst reduzierte Darstellung. Es handelt sich um eine illustrative Vereinfachung zur Veranschaulichung der Struktur, kein copy-paste-fertiges Importprofil – das vollständige CSV-Format kennt weitere Spalten, etwa für Lagerbestand, Versand oder Bilder.
Handle;Title;Option1 Name;Option1 Value;Option2 Name;Option2 Value;Variant SKU;Variant Price
hemd-classic;Hemd Classic;Farbe;Blau;Grösse;M;HEMD-CL-BL-M;29.90
hemd-classic;;Farbe;Blau;Grösse;L;HEMD-CL-BL-L;29.90
hemd-classic;;Farbe;Weiss;Grösse;M;HEMD-CL-WS-M;29.90In den Folgezeilen desselben Produkts bleibt Title leer – Shopify liest den Titel aus der ersten Zeile eines Handles. Entscheidend ist, dass Option1 Name und Option2 Name in jeder Zeile gleich benannt sind und Option1 Value/Option2 Value für jede Variante eindeutig gesetzt sind. Wie sich dieser gesamte Ableitungsschritt aus Lieferanten-PDF oder Excel-Datei automatisieren lässt, beschreibt Produktdaten aus Lieferantendokumenten automatisch anlegen.
4. Warum aus Lieferantendaten importierte Zeilen als eigene Produkte statt als Varianten landen
Die häufigste Beobachtung nach einem Import aus Lieferantendaten: Statt eines Produkts mit sechs Varianten entstehen sechs einzelne Produkte. Die Ursache lässt sich in den meisten Fällen auf denselben Punkt zurückführen.
Typische Ursachen, die zu prüfen sind
Uneinheitlicher Handle: Wird der Handle automatisch aus dem Produktnamen oder der Artikelnummer erzeugt, unterscheidet er sich zwischen den Varianten oft minimal – etwa durch die individuelle Artikelnummer statt einer gemeinsamen Produktbezeichnung. Bereits eine kleine Abweichung reicht, damit Shopify die Zeilen als eigenständige Produkte statt als Varianten interpretiert.
Fehlende oder inkonsistente Option1 Name/Option1 Value: Fehlen diese Angaben in einer Zeile, erzeugt der Import laut Dokumentation ein neues Standardprodukt statt einer Variante des bestehenden.
Fehlender Produkttitel: Enthält eine Zeile einen Handle, aber keinen Wert in der Title-Spalte, wird sie beim Import ignoriert.
Für Lieferantendaten bedeutet das konkret: Der Handle darf sich nicht aus einem Feld ableiten, das pro Variante unterschiedlich ist, wie der Artikelnummer. Er sollte stattdessen aus einem Feld stammen, das für alle Varianten eines Produkts identisch ist – im Beispiel aus „Hemd Classic”, nicht aus „HEMD-CL-BL-M”. Wird die Ableitung automatisiert, lohnt sich deshalb eine bewusste Entscheidung, welches Lieferantenfeld als Grundlage für den Handle dient, bevor die eigentliche Zeilenerzeugung beginnt – eine nachträgliche Korrektur bereits importierter, fälschlich getrennter Produkte ist deutlich aufwändiger als eine saubere Ableitung von Anfang an.
5. Das Varianten-Limit 2025: 2048 statt 100 – aber weiterhin nur drei Optionen
Bis vor Kurzem lag die Grenze für Varianten pro Produkt bei 100 – eine Zahl, die in vielen älteren Anleitungen und Foreneinträgen noch immer als aktuelle Grenze genannt wird. Seit dem 15. Oktober 2025 hat Shopify laut eigenem Änderungsprotokoll diese Grenze für alle Händler auf 2048 Varianten pro Produkt angehoben.
Zwei unterschiedliche Grenzen, oft verwechselt
Das Varianten-Limit (aktuell 2048) und das Options-Limit (weiterhin 3) sind zwei unabhängige Werte. Ein Produkt mit den drei Optionen Grösse, Farbe und Material kann rechnerisch weit mehr als 2048 Kombinationen ergeben – begrenzend wirkt dann das Varianten-Limit, nicht die Anzahl der Optionen. Umgekehrt lässt sich ein viertes Merkmal wie eine individuelle Gravur nicht ergänzen, selbst wenn von den 2048 möglichen Varianten noch viele frei wären, weil die Options-Grenze bei drei bleibt.
Für Lieferantendaten mit sehr vielen Grössen-, Farb- oder Ausführungskombinationen – etwa in der Beschläge- oder Bekleidungsbranche – bedeutet das praktisch: Ein einzelnes Produkt mit vielen hundert Varianten ist inzwischen technisch möglich, sofern nicht mehr als drei unterscheidende Merkmale vorliegen. Wo vorher aus Kapazitätsgründen mehrere Produkte künstlich getrennt werden mussten, kann seit Oktober 2025 unter Umständen ein einziges Produkt genügen. Ob sich das im Einzelfall lohnt, oder ob getrennte Produkte aus anderen Gründen – etwa unterschiedlichen Produktbeschreibungen oder Bildwelten – weiterhin sinnvoller sind, ist von Fall zu Fall zu prüfen.
6. Mehr als drei Merkmale: Combined Listings als Workaround
Braucht ein Produkt tatsächlich ein viertes unterscheidendes Merkmal – im Beispiel etwa zusätzlich zu Grösse und Farbe noch das Material –, lässt sich das nicht als vierte Option abbilden. Shopify bietet dafür Combined Listings an: mehrere eigenständige Produkte werden zu einer gemeinsamen Ansicht im Storefront zusammengefasst, wobei jedes Kindprodukt weiterhin eigene Bilder, Beschreibung und URL behalten kann.
Verfügbarkeit laut Dokumentation
Combined Listings sind laut Shopify-Dokumentation ausschliesslich auf Plus- und Enterprise-Plänen verfügbar. Ausserdem wird der Online Store Sales Channel sowie ein kompatibles Theme vorausgesetzt. Auf Basic- oder Standard-Plänen steht dieser native Weg nicht zur Verfügung – ob und wie sich ein viertes Merkmal dort sinnvoll abbilden lässt, ist im Einzelfall zu prüfen.
Für die technischen Grenzen von Combined Listings selbst nennt die Dokumentation konkrete Werte: Bis zu 60 Produkte lassen sich zu einer Combined Listing zusammenfassen, zusätzlich zu den Optionen der einzelnen Kindprodukte können bis zu 3 weitere Optionen auf Ebene der Combined Listing ergänzt werden, und über alle Kindprodukte hinweg sind bis zu 2000 Varianten-Optionswerte kombinierbar. Jedes Kindprodukt bleibt dabei ein eigenständiges Produkt mit eigenem Handle – aus Sicht der Lieferantendaten bedeutet das, dass die Ableitung nicht mehr auf ein einzelnes Zielprodukt, sondern auf mehrere, bewusst miteinander verknüpfte Produkte ausgerichtet werden muss.
Vor der Entscheidung prüfen
Bevor Lieferantendaten mit vier oder mehr Merkmalen auf Combined Listings ausgelegt werden, lohnt sich die Prüfung, ob sich eines der Merkmale nicht doch sinnvoller als reine Produktinformation statt als kaufentscheidende Variante abbilden lässt – etwa wenn ein Merkmal für die Kaufentscheidung selbst keine Rolle spielt.
7. Prüfen, bevor importiert wird
Ein grosser Teil der in Abschnitt 4 beschriebenen Probleme lässt sich vor dem eigentlichen Import erkennen. Aus der Shopify-Dokumentation zu häufigen Importfehlern lässt sich eine Prüfliste ableiten, die sich vor jedem Import aus Lieferantendaten bewährt:
- Ist die Datei UTF-8-kodiert? Fehlerhafte Kodierung äussert sich häufig in verstümmelten Sonderzeichen.
- Enthält die Datei „intelligente” Anführungszeichen aus einer Tabellenkalkulation statt gerader Anführungszeichen? Diese führen laut Dokumentation zu Fehlern wie „Missing or stray quote”.
- Ist der
Handlefür alle Varianten eines Produkts identisch und gleichzeitig gegenüber anderen Produkten eindeutig? - Ist in jeder Zeile ein Preis hinterlegt? Ein leeres Preisfeld führt zu einem Validierungsfehler.
- Hat jede Zeile mit einem Handle auch einen Titel, zumindest in der ersten Zeile des jeweiligen Handles?
- Liegen referenzierte Produktbilder innerhalb der dokumentierten Grössengrenzen (maximal 5000 × 5000 Pixel beziehungsweise 25 Megapixel) und sind sie über eine öffentlich erreichbare Adresse eingebunden?
Menschlicher Prüfschritt bei fremden Dokumenten
Bei Daten, die aus einem Lieferanten-PDF oder einer uneinheitlichen Excel-Datei abgeleitet wurden, kommt ein weiterer Punkt hinzu: Diese Daten wurden nicht für den direkten Import erzeugt, sondern für die menschliche Lektüre. Ein Prüfschritt, in dem eine Person die abgeleiteten Daten stichprobenartig mit dem Ursprungsdokument abgleicht, bevor sie produktiv übernommen werden, ist bei dieser Art von Quelle sinnvoll – unabhängig davon, ob die Ableitung von Hand oder automatisiert erfolgt.
8. Importdatei oder API: wann was sinnvoll ist
Für das Anlegen und Aktualisieren von Varianten stehen grundsätzlich zwei Wege offen: die CSV-Importdatei über die Shopify-Admin-Oberfläche oder die direkte Anbindung über die Shopify Admin API. Beide haben einen klaren Anwendungsbereich.
| Kriterium | Importdatei | API |
|---|---|---|
| Eignet sich für | Einmalige oder gelegentliche Aktionen | Wiederkehrende, automatisierte Abläufe |
| Datenmenge | Überschaubare, absehbare Mengen | Grosse oder laufend wechselnde Mengen, mehrere Lieferanten |
| Entwicklungsaufwand | Keiner, Bordmittel von Shopify genügen | Anbindung und Fehlerbehandlung müssen entwickelt werden |
| Fehlerbehandlung | Manuell anhand der Import-Fehlermeldungen | Kann direkt im Prozess geprüft und behandelt werden |
| Grenzen | Komplexe, stark verschachtelte Strukturen sind mühsam | Ohne Entwicklungsaufwand nicht nutzbar |
Die ehrliche Einschätzung fällt entsprechend eindeutig aus: Wer einmal im Jahr eine neue Kollektion mit überschaubarer Variantenzahl einspielt, braucht dafür keine API-Anbindung – die Importdatei erledigt das ohne zusätzlichen Aufwand. Wer dagegen wöchentlich Lieferantendateien in wechselnden Formaten von mehreren Lieferanten verarbeitet, spart mit der Importdatei nichts, weil die manuelle Aufbereitung jede Woche erneut anfällt. In diesem Fall amortisiert sich der Aufwand für eine Anbindung über die Admin API durch die Wiederholung.
Dazwischen liegt ein breiter Bereich, in dem beide Wege vertretbar sind: eine Handvoll Lieferanten mit monatlichen Aktualisierungen lässt sich mit der Importdatei bewältigen, sofern jemand die Aufbereitung übernimmt und dafür regelmässig Zeit einplant. Steigt die Anzahl der Lieferanten oder die Häufigkeit der Aktualisierungen, verschiebt sich der Aufwand zunehmend von der einmaligen Entwicklung hin zur wiederkehrenden manuellen Pflege – und damit tendenziell in Richtung API. Für laufende, wiederkehrende Prozesse rund um den eigenen Shopify-Shop liefert Shopify-Automatisierung einen umfassenderen Überblick.
Grundlage für die in diesem Beitrag genannten technischen Regeln ist die offizielle Shopify-Dokumentation zu Produkt-CSV-Import, Varianten und Combined Listings.