Ein Handle ist in Shopify der eindeutige, technische Bezeichner eines Produkts, einer Sammlung, einer Seite oder eines Blogartikels.
Er dient als Teil der URL und als interner Schlüssel, über den Shopify Inhalte eindeutig identifiziert.
Beispiel
Beispiel:
Ein Produkt mit dem Titel „Schwarze Sonnenbrille“ erhält automatisch den Handle schwarze-sonnenbrille und ist unter folgender URL erreichbar:https://deinshop.myshopify.com/products/schwarze-sonnenbrille
- Die Spalte Handle ist eine der wichtigsten beim Produkt-CSV-Import. Die Handle-Spalte ist erforderlich, wenn Varianten enthalten sind.
- Außerdem: Beim Aktualisieren von Produkten via CSV sind Handle und Title die einzigen Pflichtspalten.
Weitere Handles bzw. verwandte Spalten, die berücksichtigt werden sollten #
- Beim Varianten-Import: Wenn Varianten vorhanden sind, dann müssen unter anderem „Option1 Name“, „Option1 Value“ etc. mitgeführt werden. Die Handle-Spalte bleibt in allen Zeilen der Variante derselbe Wert.
- Beim Überarbeiten (update) von Produkten: Der Handle bleibt der Anker – d. h. wenn ein Import stattfindet und „Produkte mit demselben handle ersetzen“ ausgewählt ist, wird anhand des Handles entschieden, ob ein Produkt überschrieben wird.
- Beim Export/Import von Inventar-CSV (separat vom Produkt-CSV) wird ebenfalls die Spalte Handle als eindeutige Produkt-ID erkannt.
Sonderfälle / Hinweise #
- Wenn ein neues Produkt ohne Varianten angelegt wird: Die einzige Pflichtspalte ist Title; die Handle-Spalte ist hier nicht zwingend erforderlich beim Import neuer Produkte.
- Beim Export/Import von Inventar oder anderen CSV-Dateien (nicht Produkt-CSV) kann der Handle eine etwas andere Rolle spielen – z. B. als Referenz auf das Produkt im Inventar-Import
Fehlerfälle
Wenn in der CSV ein Handle mehrfach vorkommt oder dasselbe Handle bereits existiert, kann der Import ignorieren oder fehlschlagen. („Ignoriere Zeile … weil das Handle schwarze-sonnenbrille bereits existiert.“)
Empfehlung zur Priorisierung #
- Priorität 1: Handle in Produkt-CSV (neue Produkte mit Varianten / Updates)
- Priorität 2: Varianten-bezogene Spalten mit gleichem Handle (Option1 Name/Value etc)
- Priorität 3: Use-Cases wie Inventar-CSV oder spezielle Apps – hier ist Handle relevant, aber als Teil eines anderen Formats
- Sonderfall: Neue einfache Produkte ohne Varianten → Handle kann entfallen, Title ist ausreichend
