Was sind Shopify Metafields?
Shopify Metafields (deutsch: Metafelder) sind zusätzliche Datenfelder, die du an bestehende Shopify-Ressourcen anhängst. Statt Informationen in den Beschreibungstext zu quetschen, definierst du ein eigenes Feld mit eigenem Datentyp, eigener Validierung und eigener Anzeige im Shop.
Ein Beispiel: Du verkaufst Outdoorjacken. Shopify kennt Titel, Preis und Varianten. Zusätzlich brauchst du die Wassersäule in Millimetern (Zahl), Pflegehinweise (Text), kompatibles Zubehör (Produktverknüpfung) und eine OEKO-TEX-Zertifizierung (Ja/Nein). Keines dieser Felder gehört in den Fließtext. Alle vier sind klassische Metafields: strukturierte Daten, die du gezielt befüllst und im Theme ausspielst.
Der Nutzen ist doppelt: Kunden finden alle kaufentscheidenden Infos direkt auf der Produktseite (weniger Support, mehr Conversion), und Google versteht strukturierte Daten besser als Fließtext (Grundlage für Rich Snippets). Was Shopify grundsätzlich ausmacht, liest du in unserem Leitfaden zu Was ist Shopify.
Metafields vs. Metaobjects: Was ist der Unterschied?
Die häufigste Verwechslung, und die wichtigste Entscheidung, bevor du anfängst. Beide findest du im Admin unter „Einstellungen → Benutzerdefinierte Daten".
Faustregel: Ist die Information produktspezifisch und von Produkt zu Produkt verschieden, nimmst du ein Metafield. Willst du denselben Inhalt an mehreren Stellen zentral verwalten oder aus einer festen Werteliste auswählen, nimmst du ein Metaobject und verknüpfst es per Referenz-Metafield. Genau dieses Muster nutzen wir im Praxisbeispiel weiter unten.
Welche Shopify Metafield-Typen gibt es?
Der richtige Typ entscheidet über Datenqualität, Filterbarkeit und ob später Schema Markup greift. Ein Textfeld für eine Maßangabe ist maschinell nicht auswertbar, ein Measurement-Typ schon.
Wichtig: Fast alle Typen gibt es auch als Liste, sodass du mehrere Werte (z. B. mehrere verknüpfte Produkte oder Dateien) in einem einzigen Metafeld speicherst.
Wo kannst du Metafields einsetzen?
Metafields lassen sich an fast jeden Bereich des Shops anhängen. Das macht sie so flexibel:
- Produkt-Metafields: die häufigste Anwendung, für Materialien, Maße, Pflegehinweise, Zertifizierungen oder Zusatzdateien.
- Varianten-Metafields: wenn Infos je Variante unterschiedlich sind, etwa Farbcode je Farbe oder Lieferzeit je Ausführung.
- Collection-Metafields: SEO-Texte, Bannerbilder oder Filter-Beschriftungen direkt an der Kategorie statt hardcoded im Theme.
- Kunden-Metafields: B2B-Kundennummern, Rabattstufen oder Lieferbedingungen, nutzbar in Shopify Flow. Für den Großhandel besonders relevant, mehr dazu in unserem Artikel zu [Shopify Plus
- Bestellungs-Metafields: Geschenknotiz, Wunschlieferdatum oder interne Fulfillment-Flags.
- Seiten- und Blog-Metafields: Autorendaten, Quellen oder strukturierte Daten für Redaktionsprozesse.
Shopify Metafields einrichten: Schritt für Schritt
Die Einrichtung läuft immer in drei Phasen ab: erst die Definition, dann die Werte, dann die Anzeige.
Schritt 1: Metafield-Definition anlegen
Gehe im Shopify-Admin zu „Einstellungen → Benutzerdefinierte Daten", wähle die Ressource (z. B. Produkte) und klicke auf „Definition hinzufügen". Du konfigurierst:
- Name: wie das Feld im Admin heißt, z. B. „Pflegehinweise".
- Namespace und Schlüssel: der technische Bezeichner, den du später im Liquid-Code brauchst (z. B. custom.pflegehinweise).
- Typ: der passende Metafield-Typ aus der Liste oben.
- Validierungen: Pflichtfeld, Zeichenlimit, Minimum/Maximum.
Tipp: Shopify bietet für gängige Fälle Standard-Definitionen (Pflegehinweise, Inhaltsstoffe, Größentabelle). Nutze sie, wenn sie passen, sie sind universell kompatibel.
Schritt 2: Metafield-Werte befüllen
Nach dem Anlegen pinnst du die Definition an, dann erscheint das Feld direkt in der Produktmaske. Öffne ein Produkt, scrolle nach unten und befülle das Feld. Für viele Produkte auf einmal nutzt du den Bulk-Editor oder den CSV- bzw. API-Weg (siehe unten).
Schritt 3: Metafield anpinnen
Damit das Feld bei jeder Ressource sichtbar in der Bearbeitungsmaske auftaucht, pinnst du es in der Definitionsübersicht an. Das spart deinem Team später viel Sucherei.
Wie zeige ich Metafields im Shop an?
Ein befülltes Metafield, das im Frontend nicht erscheint, bringt nichts. Es gibt zwei Wege.
Weg 1: Theme-Editor (ohne Code)
Mit einem Online-Store-2.0-Theme (Dawn, Impulse, Prestige und andere) verknüpfst du Metafields direkt als dynamische Quelle:
- Theme-Editor öffnen (Online-Store → Themes → Anpassen).
- Zur Produktseite navigieren.
- Block hinzufügen (z. B. „Text").
- Auf das Verknüpfungs-Symbol klicken und dein Metafield als dynamische Quelle wählen.
Der Wert erscheint automatisch. Für die meisten Standardfälle reicht das völlig aus.
Weg 2: Liquid-Code (für individuelle Darstellung)
Wenn der Theme-Editor nicht ausreicht, greifst du im Theme-Code auf das Metafeld zu. Der Aufbau ist immer Ressource.metafields.Namespace.Schlüssel.value:
{{ product.metafields.custom.pflegehinweise.value }}Für Referenztypen (z. B. eine verknüpfte Datei):
{% assign handbuch = product.metafields.custom.handbuch_pdf.value %} <a href="{{ handbuch.url }}" target="_blank">Handbuch herunterladen</a>Für Listen (z. B. mehrere verknüpfte Produkte):
{% for related in product.metafields.custom.aehnliche_produkte.value %}
<a href="{{ related.url }}">{{ related.title }}</a>
{% endfor %}Wichtig: Änderungen am Theme-Code nur mit Liquid-Erfahrung und immer mit vorherigem Theme-Backup. Wenn du komplexere Darstellungen oder eine saubere, wartbare Architektur brauchst, übernimmt das unsere Shopify-App-Entwicklung.
Metafields per CSV importieren
Für große Sortimente ist die Einzeleingabe unrealistisch. Der Standardweg ist ein CSV-Import über eine App wie Matrixify. Dort legst du pro Metafeld eine Spalte im Format Metafield: namespace.key [type] an, z. B. Metafield: custom.wassersaeule [number_integer], und befüllst sie zeilenweise pro Produkt. So bringst du auch tausende Werte konsistent ins System. Achte darauf, dass Namespace, Key und Typ exakt mit der Definition übereinstimmen, sonst wird der Wert nicht zugeordnet.
Metafields über die API und GraphQL
Wer Metafields aus einem PIM, ERP oder einer eigenen Anwendung heraus pflegt, nutzt die Shopify Admin API. Über die GraphQL-Mutation `metafieldsSet` schreibst oder aktualisierst du Werte gezielt:
graphql
mutation {
metafieldsSet(metafields: [{
ownerId: "gid://shopify/Product/1234567890",
namespace: "custom",
key: "wassersaeule",
type: "number_integer",
value: "10000"
}]) {
metafields { id key value }
userErrors { field message }
}
}Auslesen kannst du sie ebenso gezielt, auch für Varianten, Bestellungen oder Kunden:
graphql
{
product(id: "gid://shopify/Product/1234567890") {
metafield(namespace: "custom", key: "wassersaeule") { value type }
}
}Dieser Weg lohnt sich, sobald Metafield-Werte automatisiert und regelmäßig aus einer Quellsystem-Anbindung aktualisiert werden sollen. Genau solche Schnittstellen bauen wir im Rahmen unserer Shopify-App-Entwicklung.
Namespace und Key: die wichtigsten Best Practices
Der Namespace ist der Ordner, der Schlüssel der Dateiname deiner Daten. Ein sauberes Konzept spart später viel Aufwand:
- Lege einen festen Standard fest, üblich ist custom. für alle shop-eigenen Felder.
- Verwende sprechende, konsistente Keys in einer Sprache (z. B. immer custom.pflegehinweise, nicht mal deutsch, mal englisch).
- Von Apps reservierte Namespaces (erkennbar an Präfixen) nicht selbst überschreiben.
- Dokumentiere die Befüllungsstandards, damit „100 % Baumwolle" nicht mal als „100% Cotton" im Feld landet, sonst verliert das Feld seinen strukturellen Wert.
Praxisbeispiele: So setzen wir Metafields und Metaobjects ein
Wie stark strukturierte Daten in der Praxis wirken, zeigen zwei unserer Projekte.
Tracht À Porter: Für den Fashion-Shop haben wir Custom Metaobjects mit vordefinierten Werten für Pflegehinweise und Ausschnittsformen angelegt. Statt jeden Hinweis frei zu tippen, wählt das Team im Produkt-Backend einfach aus einem Dropdown den passenden Wert aus. Das Ergebnis: konsistente, fehlerfreie Produktdaten, die zentral gepflegt und im Frontend einheitlich ausgespielt werden. Die ganze Umsetzung findest du in unserer Tracht-À-Porter-Referenz.
Miss Goodlife: Hier haben wir Custom Badges definiert, die sich ebenfalls per Dropdown auswählen lassen und direkt im Frontend auf der Produktseite erscheinen. So kann das Team ohne Entwickler Produkte mit Auszeichnungen wie „Bestseller" oder „Neu" versehen, ein kleiner, aber wirksamer Conversion-Hebel. Mehr dazu in der Miss-Goodlife-Referenz.
Beide Fälle zeigen dasselbe Prinzip: vordefinierte, strukturierte Werte, die im Backend einfach auswählbar und im Frontend sauber angezeigt werden.
Metafields und SEO: das unterschätzte Potenzial
Metafields wirken weit über die Produktseite hinaus und sind ein direkter SEO-Hebel, den die meisten Shops nicht ausschöpfen:
- Strukturierte Daten (Schema Markup): Metafields mit den richtigen Typen (Measurement, Rating, Product) lassen sich über Apps wie „JSON-LD for SEO" oder per Liquid in Schema Markup umwandeln. Das ermöglicht Rich Snippets und Sternebewertungen in den Suchergebnissen. Entscheidend: Das Schema greift nur mit dem korrekten Datentyp.
- Collection-SEO: Mit einem Collection-Metafeld vom Typ Rich Text hinterlegst du je Kategorie einen individuellen SEO-Text, sauber getrennt von der Produktliste. Einer der wirksamsten Shopify-SEO-Hebel überhaupt, mehr dazu in unserem Shopify-SEO-Leitfaden.
- AI Overviews: Strukturierte Produktdaten werden von KI-Suchsystemen (Google AI Overviews, Perplexity) bevorzugt herangezogen. Sauberes Schema aus Metafields erhöht die Chance, zitiert zu werden.
Weil Metafields so direkt auf bessere Produktinfos, Trust-Badges und Filter einzahlen, sind sie auch ein Baustein der Conversion-Optimierung: mehr Klarheit auf der Produktseite bedeutet weniger Kaufabbrüche.
Apps für Metafields: wann sie sich lohnen
Die native Metafields-Verwaltung reicht für viele Shops aus. Apps sind sinnvoll bei:
- Massen-Bearbeitung: Metafields Guru oder Accentuate Custom Fields für tabellarische Bearbeitung vieler Produkte.
- CSV-Import/-Export: Matrixify als Standardlösung für professionelle Setups.
- Automatisches Schema Markup: JSON-LD for SEO wandelt Metafield-Werte ohne Liquid in strukturierte Daten um.
Achtung Performance: Jede App lädt zusätzliches JavaScript. Installiere nur, was du aktiv nutzt, sonst leidet die Ladezeit.
Häufige Fehler bei Shopify Metafields
- Falscher Datentyp: Einzeiliger Text für Maße statt Measurement, dann sind die Daten nicht maschinenlesbar und Schema Markup greift nicht.
- Kein Namespace-Konzept: willkürliche Vergabe macht den Liquid-Code unlesbar und die Teamarbeit schwer.
- Metafields ohne Theme-Integration: angelegt, befüllt, aber nie angezeigt, kein Mehrwert für Kunden oder SEO.
- Definition gelöscht ohne Theme-Check: Wird das Feld im Liquid oder Theme-Editor referenziert, entstehen Anzeigefehler. Erst prüfen, dann löschen.
- Inkonsistente Befüllung: unterschiedliche Schreibweisen zerstören den strukturellen Wert des Felds.
Fazit: Metafields sind die Grundlage sauberer Produktdaten
Ein Shop, der seine Produktdaten strukturiert, mit den richtigen Typen, sauber im Theme angezeigt und für SEO genutzt, hat einen messbaren Vorteil gegenüber Shops, die alles in den Beschreibungstext packen. Metafields sind kein technisches Extra, sondern die Basis für Produktdaten, die Google versteht und Kunden überzeugen.
Fang mit den Feldern an, die dein Sortiment konkret braucht, mit dem passenden Typ und verknüpft im Theme. Wenn du eine skalierbare Metafield- und Metaobject-Architektur von Anfang an sauber aufbauen willst, unterstützt dich unsere Shopify-Agentur mit passender App- und Custom-Entwicklung.
Metafield-Architektur, die skaliert? Wir bauen deine Metafield- und Metaobject-Struktur sauber auf, im Theme verankert und auf dein Sortiment zugeschnitten.
Autor
Jakob ist Webentwickler bei refrsh und setzt Shopify-Projekte technisch um – von individuellen Themes bis zu maßgeschneiderten Funktionen. Sein Fokus liegt auf sauberem Code, Performance und Shops, die im Alltag zuverlässig laufen.
