Zum Inhalt springen

Produkt-Metafields

Eigene Produktfelder

Zuletzt aktualisiert: 5. September 2026

Metafields sind benutzerdefinierte Felder, die du jedem Produkt hinzufügen kannst – Material, Abmessungen, ISBN, Pflegehinweise, Downloads und alles andere, was die Standardfelder nicht abdecken. Sie werden auf der Produktseite angezeigt und sind über die REST-API verfügbar.

Metafields hinzufügen #

Bearbeite ein Produkt (Admin → Katalog → Produkte) und öffne den Reiter Metafields. Lege ein Feld an mit:

  • Key – ein kurzer maschinenlesbarer Name, z. B. material
  • Label – der Anzeigename (standardmäßig eine aufbereitete Fassung des Keys)
  • Type – Text, mehrzeilig, Zahl, URL, Datum, Boolean oder JSON
  • Value
  • In der Storefront anzeigen – ob das Feld auf der Produktseite erscheint

Lege beliebig viele Felder an und ordne sie neu.

Wo sie erscheinen #

  • Storefront – sichtbare Metafields werden im Reiter Spezifikationen des Produkts dargestellt (Booleans als Ja/Nein, URLs als Links).
  • REST-API – sichtbare Metafields sind im Produkt-Endpunkt unter metafields enthalten, jeweils mit Namespace, Key, Typ und typisiertem Wert – praktisch für Integrationen und Headless-Storefronts.

Hinweise #

Thema Detail
Typen Werte werden über die API korrekt typisiert zurückgegeben (Zahlen als Zahlen, Booleans als true/false, JSON geparst)
Sichtbarkeit Ausgeblendete Metafields bleiben für den internen Gebrauch erhalten und sind weder in der Storefront noch in der API enthalten
Namespacing Felder verwenden standardmäßig den Namespace custom