Skip to main content

Shopify URL-Handle

Überblick

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:
Ein Produkt mit dem Titel „Schwarze Sonnenbrille“ erhält automatisch den Handle schwarze-sonnenbrille
und ist unter der URL erreichbar:
https://deinshop.myshopify.com/products/schwarze-sonnenbrille

Wichtigste Handles

  • Die Spalte Handle ist eine der wichtigsten beim Produkt-CSV-Import. Laut Dokumentation ist die Handle-Spalte erforderlich wenn Varianten enthalten sind. Shopify Help Center+1

  • Außerdem: Beim Aktualisieren von Produkten via CSV sind Handle und Title die einzigen Pflichtspalten. Shopify Help Center+1

  • Wichtig: Der Handle dient als eindeutiger Bezeichner eines Produkts im Shop – z. B. beim Import wird geprüft, ob ein Produkt mit diesem Handle bereits existiert. Shopify Help Center

  • Die Dokumentation nennt: „Handle (required) … Dieser Wert wird basierend auf dem Wert in der Spalte Title erstellt. Wenn beispielsweise in der Spalte Title der Wert Black Sun Glasses ist, ist der Wert in dieser Spalte black-sun-glasses.“ Shopify Help Center

Kurz: Handle = zentrale Spalte, mit der Shopify Produkte identifiziert und zugeordnet werden.

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. Shopify Help Center+1

  • 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. Shopify Help Center+1

  • Beim Export/Import von Inventar-CSV (separat vom Produkt-CSV) wird ebenfalls die Spalte Handle als eindeutige Produkt-ID genannt. Shopify Help Center

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. Shopify Help Center+1

  • Beim Export/Import von Inventar oder anderen CSV-Dateien (nicht Produkt-CSV) kann der Handle etwas andere Rolle spielen – z. B. als Referenz auf das Produkt im Inventar-Import. Beispiel: „Handle: eindeutige Produkt-ID; … Ein Handle wird in der URL für jedes Produkt verwendet.“ Shopify Help Center

  • 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 example bereits existiert.“) Shopify Help Center

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

Back to top