Metafields und Metaobjects in Shopify nutzen

Shopify bringt von Haus aus eine feste Datenbankstruktur mit: Produkte, Varianten, Kunden, Bestellungen. Was, wenn du darüber hinaus eigene Informationen speichern und im Shop anzeigen willst? Genau dafür gibt es Metafields und Metaobjects. Sie machen Shopify erweiterbar, ohne dass du in den Plattform-Kern eingreifen oder eine App installieren musst, die nur einen einzigen Zweck erfüllt.

Was sind Metafields?

Metafields erlauben dir, bestehende Shopify-Entitäten um eigene Felder zu erweitern. Du kannst Metafields an Produkte, Varianten, Kollektionen, Kunden, Bestellungen, Seiten oder deinen Shop selbst hängen.

Ein Beispiel: Du verkaufst Outdoor-Ausrüstung und willst für jedes Produkt ein Feld “Technisches Datenblatt (PDF)” sowie ein Feld “Einsatztemperatur in Grad Celsius” anzeigen. Beides gehört nicht ins Standard-Produkt-Schema von Shopify. Mit Metafields definierst du diese Felder einmal als Definition und befüllst sie dann im Admin für jedes Produkt einzeln.

Unterstützte Feldtypen umfassen unter anderem einfachen Text, mehrzeiligen Text, Ganzzahlen, Dezimalzahlen, Datum und Uhrzeit, Farben, URLs, Dateien, Produkt-, Kollektions- oder Seitenreferenzen sowie Listen dieser Typen. Ab API-Version 2026-04 gilt für JSON-Felder eine Größenbeschränkung von 128 KB, alle anderen Feldtypen sind auf 64 KB begrenzt.

Was sind Metaobjects?

Metaobjects gehen einen Schritt weiter. Statt ein einzelnes Feld an eine bestehende Entität zu hängen, definierst du einen vollständig neuen Objekttyp mit mehreren eigenen Feldern. Dieser Objekttyp kann dann eigenständig befüllt und referenziert werden.

Stell dir vor, du betreibst einen Weinhandel. Du willst für jeden Wein einen strukturierten “Winzer”-Eintrag anlegen, der aus Name, Porträtbild, Region, Beschreibung und einer Link-URL besteht. Ein einzelnes Metafield würde hier nicht reichen. Ein Metaobject “Winzer” mit fünf Feldern schon. Du legst jeden Winzer einmal an und verlinkst ihn dann von beliebig vielen Produkten.

Metaobjects können im Theme über Liquid angezeigt oder über die Storefront API abgerufen werden. Du kannst sie sogar als Basis für eigenständige Seiten verwenden, was sie besonders interessant für strukturierte Content-Bereiche macht, zum Beispiel Influencer-Profile, Veranstaltungshistorien oder Zertifizierungsübersichten.

Metafields im Admin einrichten

Den Einstieg findest du im Shopify Admin unter “Einstellungen” und dann “Benutzerdefinierte Daten”. Dort legst du Definitionen an, also den Bauplan eines Metafields oder Metaobjects.

Wichtig: Eine Definition legt Namespace, Schlüssel und Feldtyp fest. Der Namespace dient zur logischen Gruppierung, zum Beispiel product_specs. Der Schlüssel ist der eindeutige Bezeichner innerhalb des Namespace, zum Beispiel material oder weight_kg. Sobald die Definition steht, erscheint das Feld an der jeweiligen Entität im Admin und kann befüllt werden.

Shopify bietet außerdem sogenannte Standard-Metafeld-Definitionen an. Das sind vordefinierte Definitionen für häufige Anwendungsfälle wie Pflegehinweise, Produktvideos oder Nährwertangaben. Wenn du eines dieser Standardfelder nutzt, erhält es automatisch semantische Bedeutung, was unter anderem für die Darstellung in Suchmaschinenergebnissen relevant sein kann.

Metafields im Theme anzeigen

Das Anzeigen von Metafields im Storefront ist in zwei Varianten möglich.

Über den Theme-Editor: Wenn dein Theme Metafields unterstützt (was bei allen modernen Online Store 2.0-Themes der Fall ist), kannst du Metafields direkt im Editor mit Theme-Blöcken verknüpfen. Du ziehst einen Block an die gewünschte Stelle und verbindest ihn mit dem Metafeld deiner Wahl. Kein Code notwendig.

Über Liquid: Wenn du mehr Kontrolle willst oder ein komplexeres Layout brauchst, greifst du per Liquid auf Metafields zu. Der Zugriff erfolgt über product.metafields.namespace.key für Produkte, entsprechend für andere Entitäten. Für Metaobjects nutzt du metaobject.fields.field_key. Wie Shopify Sections und Blocks arbeiten und wie du dabei auf Metafields zurückgreifst, gehört heute zum Standard-Handwerk bei Theme-Anpassungen.

Sinnvolle Einsatzszenarien aus der Praxis

In Projekten begegnen uns immer wieder ähnliche Anforderungen, die sich mit Metafields und Metaobjects elegant lösen lassen:

• Technische Produktdaten strukturiert darstellen: Maße, Gewichte, Zertifizierungen, Kompatibilitätslisten. Statt alles in die Produktbeschreibung zu schreiben, werden Felder sauber getrennt und können in Vergleichstabellen oder per Liquid-Template angezeigt werden.
• Teammitglieder oder Experten-Profile: Ein Metaobject “Berater” mit Bild, Name, Fachgebiet und Zitat. Referenzierbar von Kategorienseiten oder Landing Pages.
• Produktkonfigurationshinweise: Welche Zubehörteile passen, welche Einschränkungen gelten, welche Lieferzeiten abweichen. Struktur statt Freitext.
• B2B-spezifische Daten: Mindestbestellmengen, Staffelpreishinweise, Händlerrabattklassen. Im Zusammenspiel mit B2B-Katalogen und Preislisten lassen sich so maßgeschneiderte Erlebnisse bauen.
• Produktkonfiguratoren: Metafields liefern die strukturierten Grunddaten, auf denen ein Shopify Produktkonfigurator aufbaut. Ohne saubere Datenbasis kein funktionierender Konfigurator.

Grenzen kennen und realistisch planen

Metafields und Metaobjects sind mächtig, aber sie haben Grenzen, die du kennen solltest.

Metaobject-Einträge sind pro Definition auf 1.000.000 Einträge begrenzt (Stand 2026, nach einem Anstieg gegenüber früheren plan-abhängigen Limits). Die Anzahl der Metaobject-Definitionen pro installierter App liegt bei 128. Für JSON-Felder gilt ab API 2026-04 ein 128-KB-Limit, für alle anderen Typen 64 KB.

Eine weitere Einschränkung betrifft die Performance: Wenn du Metaobjects per Storefront API in großen Mengen abrufst, solltest du Pagination und Caching von Anfang an mitdenken. Ungeachtet dessen sind Metafields serverseitig und werden bei Shopify gespeichert, nicht im Theme-Code. Das macht sie portabler als hardcodierte Lösungen, aber auch weniger flexibel als eine eigene Datenbank.

Schließlich gilt: Shopify Liquid kann Metaobjects darstellen, aber komplexe Verknüpfungen, zum Beispiel mehrere Metaobjects, die aufeinander referenzieren, werden im Theme schnell unübersichtlich. Für sehr komplexe Datenmodelle empfiehlt sich ein Headless-Ansatz mit der Storefront API, bei dem die Datenlogik in einer separaten Frontend-Applikation liegt.

Häufige Fragen

Kann ich Metafields ohne Programmierkenntnisse einrichten?

Ja. Das Anlegen von Definitionen und das Befüllen von Werten läuft vollständig im Shopify Admin ab. Für die Anzeige im Storefront brauchst du bei Online Store 2.0-Themes ebenfalls keinen Code, weil der Theme-Editor die Verknüpfung übernimmt. Liquid-Kenntnisse brauchst du erst, wenn du das Layout anpassen oder Metafields in eigene Sections einbauen willst.

Was ist der Unterschied zwischen einem Metafield und einem Custom Field in anderen Systemen?

Der Begriff ist weitgehend identisch. Shopware nennt es Custom Fields, Shopify nennt es Metafields. Der wesentliche Unterschied zu Shopware: Shopify trennt zwischen einfachen Metafields (ein Feld an einer Entität) und Metaobjects (eigenständiger Objekttyp mit mehreren Feldern). Shopware löst das über Custom Field Sets mit mehreren Feldern pro Entität.

Können Apps auf Metafields zugreifen?

Ja. Metafields und Metaobjects sind über die Admin API und die Storefront API zugänglich. Apps können Definitionen anlegen, Werte lesen und schreiben. Das macht sie zur bevorzugten Datenstruktur für App-Entwickler, die Daten persistent in einem Shop speichern wollen, ohne eine eigene externe Datenbank zu betreiben.

Werden Metafields bei einer Theme-Migration mitgenommen?

Metafields und ihre Werte liegen im Shop-Datensatz, nicht im Theme. Ein Theme-Wechsel löscht keine Metafeld-Definitionen oder -Werte. Was wegfällt, sind die Verknüpfungen im Theme-Editor. Diese musst du nach einem Theme-Wechsel neu herstellen, was je nach Umfang einige Stunden Arbeit bedeuten kann.

Nächste Schritte

Wenn du Metafields und Metaobjects strukturiert in dein Shop-Konzept integrieren willst, lohnt sich ein Blick auf unsere Shopify-Betreuung. Wir helfen bei der Konzeption der Datenstruktur, der Theme-Implementierung und der API-Anbindung an externe Systeme.