Shopify Metafields: Definitionen, Typen und Verwaltung

Metafields sind Schlüssel-Wert-Paare, die einer Shopify-Ressource eigene Daten hinzufügen. Produkte sind die häufigsten Besitzer, aber auch Varianten, Kollektionen, Kunden, Bestellungen und der Shop selbst können Metafields tragen. Jedes Metafield besteht aus den vier Teilen in der Tabelle unten. Namespace und Key bilden zusammen seine Kennung, custom.material an einem Produkt ist also ein anderes Feld als specs.material.

Händler arbeiten meist im Namespace custom, den Shopify vorschlägt, wenn du im Admin ein Feld anlegst. Apps nutzen eigene Namespaces, und Shopify reserviert einen app-eigenen Namespace ($app in der API) für Daten, die zu einer App gehören. Das vollständige Modell steht im Metafields-Überblick auf shopify.dev.

Eine Metafield-Definition ist das Schema: Name, Namespace und Key, Typ, optionale Beschreibung und Validierungsregeln. Der Wert sind die Daten, die an einem Produkt gespeichert sind. Shopify selbst rät, zuerst die Definition anzulegen, denn erst die Definition macht aus einem Metafield ein Feld auf der Produktseite im Admin, erzwingt die Validierung und lässt dich das Feld in automatisierten Kollektionen, Admin-Filtern und, wenn dein Theme dynamische Quellen unterstützt, im Theme-Editor nutzen.

Ein Wert kann ohne Definition existieren. Die Admin API akzeptiert ihn, solange du den Typ mitsendest, was sie verlangt, wenn es für diesen Namespace, Key und Besitzertyp keine Definition gibt. Solche Werte werden gespeichert, aber niemand sieht im Admin ein typisiertes Eingabefeld dafür. Legst du später eine Definition mit demselben Namespace, Key und Typ an, kannst du die vorhandenen Werte dorthin migrieren, und Werte, die die neuen Validierungsregeln nicht erfüllen, lassen sich dann korrigieren.

Der Typ bestimmt, was ein Wert enthalten darf und wie Themes und Apps ihn lesen. Shopify gruppiert die Typen grob wie in der Tabelle. Die meisten Basistypen und alle Referenztypen gibt es auch als Liste, etwa list.single_line_text_field, außer boolean, id, json, language, money, multi_line_text_field und rich_text_field. Die vollständige, aktuelle Liste steht auf der Seite zu den Metafield-Datentypen.

Die Standard-Produkttaxonomie von Shopify gibt jedem Produkt eine Kategorie, getrennt vom frei formulierten Produkttyp. Die Kategorie steuert die Kategorie-Metafields: Attribute, die zu dieser Kategorie gehören, etwa Größe, Ausschnitt und Farbe bei Shirts. Ihre Werte sind Metaobjekt-Einträge mit Standardwerten, die auf die standardisierten Werte von Shopify verweisen, und du kannst einen Eintrag umbenennen (zum Beispiel Schwarz in Graphit) oder ein Feld mit einer Variantenoption verknüpfen, damit eine Änderung überall greift.

Die Kategorie setzt du auf der Produktseite, wo der Abschnitt mit den Kategorie-Metafeldern dann die Felder dieser Kategorie zeigt, oder in großer Menge über den Bulk-Editor oder eine CSV mit der Kategorie-ID oder dem Kategoriepfad. Wenn du eine Kategorie änderst, werden Metafields mit einem Wert oder einer Variantenverknüpfung übernommen, leere nicht. Shopify dokumentiert das auf seiner Seite zur Produktkategorie.

Für ein einzelnes Produkt reicht die Produktseite im Admin. Für einen Katalog brauchst du einen der Wege für große Mengen unten. Jeder hat eigene Regeln, also prüf sie, bevor du Hunderte Produkte änderst. Mehr zu diesen Wegen findest du unter Shopify Produkte in großer Menge bearbeiten.

Limits stören selten am ersten Tag, aber sie prägen, wie du Felder für einen wachsenden Katalog entwirfst. Jede App und jedes Team, das eigene Definitionen anlegt, schöpft aus demselben Kontingent pro Ressourcentyp. Die Zahlen unten stammen aus Shopifys Metafield-Limits und der Referenz zu MetafieldsSetInput; prüf sie vor einem größeren Ausbau noch einmal, weil Shopify sie anpasst.

Wenn Produktdaten in einem PIM liegen, wird das PIM zum Ort, an dem du Spezifikationen bearbeitest, und die Shopify-Anbindung schreibt sie in Metafields. So gibt es eine Quelle für die Werte, die sich dein Onlineshop, deine Feeds und deine Marktplätze teilen. Wichtig ist die Arbeitsteilung: Das PIM schreibt Werte, und die Definitionen, die diese Werte in Shopify sichtbar machen, werden in Shopify eingerichtet.

Die Shopify-PIM-Anbindung von WISEPIM schreibt Metafield-Werte mit metafieldsSet. Standardmäßig schreibt sie wisepim.ean, wisepim.mpn und wisepim.country_of_origin, wisepim.cost als number_decimal und wisepim.short_description als multi_line_text_field. Die Marke geht in Shopifys natives Feld für den Anbieter (Vendor), nicht in ein Metafield. Produkt-FAQs gehen, wenn du sie nutzt, als json in wisepim.faqs und wisepim.faq_schema.

Jedes Attribut, das du im Attributmanagement für Shopify aktivierst, wird ebenfalls geschrieben: unter dem Namespace wisepim mit einem Key, der aus dem Attributcode abgeleitet ist, oder zurück in seinen ursprünglichen Namespace, Key und Typ, wenn das Attribut aus einer importierten Shopify-Metafield-Definition stammt. Feld-Mappings pro Anbindung können einen Eintrag abschalten oder ihn aus einem anderen Attribut, einem festen Wert oder einer Vorlage füllen, und ein Wert, der nicht zu seinem Typ passt, wird übersprungen statt gesendet.