Shopify-Metafeld-Definitionen in großen Mengen importieren & exportieren
Eine Metafeld-Definition ist das Schema eines Metafelds in Shopify: sein Namespace und Schlüssel (zum Beispiel custom.size_guide), sein Typ (single_line_text_field, number_integer, list.product_reference, …), die Ressource, zu der es gehört, sowie seine Validierungs- und Zugriffseinstellungen. Durch Definitionen lassen sich Metafelder im Shopify-Adminbereich bearbeiten und in Themes und Filtern verwenden.
Erfahren Sie mehr über Metafelder in Shopify →
Mit DataEase können Sie Metafeld-Definitionen als Excel oder CSV exportieren und in großen Mengen erstellen — oder in einen anderen Shop kopieren. Die Metafeld-Werte selbst werden über dynamische Spalten der jeweiligen Entität importiert, wie unten und auf der Seite Metafelder beschrieben.
📊 Wie Metafelder in DataEase funktionieren
Section titled “📊 Wie Metafelder in DataEase funktionieren”Wenn Sie Daten aus DataEase exportieren, werden Metafelder als dynamische Spalten angezeigt. Das bedeutet, dass jedes Metafeld seine eigene Spalte in der Datei erhält, mit einem spezifischen Namensformat:
metafield {namespace}.{name} [{type}]
Beispiel:
Section titled “Beispiel:”metafield global.description_tag [single_line_text_field]
Diese Struktur zeigt DataEase (und Shopify), auf welches Metafeld Sie sich beziehen und in welchem Format.
🧠 Importlogik für Metafelder
Section titled “🧠 Importlogik für Metafelder”- Wenn ein Metafeld nicht in Ihrer Importdatei enthalten ist, wird es nicht geändert.
- Wenn ein Metafeld in der Datei enthalten, aber leer ist, wird es aus Shopify gelöscht.
- Wenn ein Metafeld einen Wert hat, wird es erstellt oder aktualisiert.
Dies erleichtert die Verwaltung von Metafeldern, ohne Daten zu überschreiben, die Sie nicht ändern möchten.
🧩 Unterstützte Metafeldtypen
Section titled “🧩 Unterstützte Metafeldtypen”Shopify unterstützt eine Vielzahl von Metafeldtypen. Sie können die vollständige Liste hier einsehen:
Verwenden Sie diese Typen in Ihren Spaltenüberschriften beim Importieren. Zum Beispiel:
metafield specs.material [multi_line_text_field] metafield shipping.weight [number_decimal]
📏 Metafeldgrenzen
Section titled “📏 Metafeldgrenzen”Bevor Sie mit Metafeldern arbeiten, sollten Sie sich der Shopify-Grenzen bewusst sein:
🔢 Grenzen pro Ressource
Section titled “🔢 Grenzen pro Ressource”- 250 Definitionen pro Ressourcentyp
- 20 angeheftete Definitionen pro Ressourcentyp
📦 Zeichenbeschränkungen nach Typ
Section titled “📦 Zeichenbeschränkungen nach Typ”| Typ | Zeichenbeschränkung |
|---|---|
| boolean | 65,000 |
| color | 65,000 |
| date | 65,000 |
| date_time | 65,000 |
| dimension | 65,000 |
| id | 2,048 |
| json | 2,000,000 |
| link | 65,000 |
| money | 65,000 |
| multi_line_text_field | 65,000 |
| number_decimal | 65,000 |
| number_integer | 65,000 |
| rating | 65,000 |
| rich_text_field | 65,000 |
| single_line_text_field | 65,000 |
| url | 2,048 |
| volume | 65,000 |
| weight | 65,000 |
Siehe vollständige Metafeldgrenzen →
🔐 Eigentümertypen und Zugriff (Admin API 2026-07)
Section titled “🔐 Eigentümertypen und Zugriff (Admin API 2026-07)”- Bestandsübertragungen (
TRANSFER) — Metafeld-Definitionen für Bestandsübertragungen können exportiert, importiert und zwischen Shops kopiert werden. Der Import erfordert die Berechtigung Bestandsübertragungen (read_inventory_transfers,write_inventory_transfers), die die App seit dem 27. Sep. 2026 anfordert. Bis der Shop-Inhaber DataEase öffnet und die aktualisierten Berechtigungen genehmigt, schlagenTRANSFER-Zeilen mit einem Fehler fehl, der um Genehmigung bittet; alle anderen Zeilen werden wie gewohnt importiert. - Admin-Zugriff (
accessAdmin) in Ihren eigenen Namensräumen (zum Beispielcustom) — Shopify erlaubt dort nur einen Wert, daher sendet DataEaseaccessAdminfür solche Definitionen nicht, und Shopify wendet ihn selbst an. EinPUBLIC_READ/PUBLIC_READ_WRITE-Wert in der Datei verursacht keinen Shopify-Fehler mehr. - Admin-Zugriff in App-Namensräumen (
$app,app--…) —MERCHANT_READundMERCHANT_READ_WRITEwerden unverändert gesendet; älterePUBLIC_READ/PUBLIC_READ_WRITE-Werte aus früheren Dateien werden alsMERCHANT_READ/MERCHANT_READ_WRITEgesendet.
🧰 Anwendungsbeispiel
Section titled “🧰 Anwendungsbeispiel”Fügen Sie benutzerdefinierte SEO-Tags zu Produkten hinzu:
- Exportieren Sie Produkte mit DataEase
- Fügen Sie eine neue Spalte hinzu: metafield global.title_tag [single_line_text_field]
- Geben Sie Ihre SEO-Titel in die Spalte ein
- Importieren Sie die aktualisierte Datei - Ihre Metafelder sind jetzt live!
✅ Beste Praktiken
Section titled “✅ Beste Praktiken”- Verwenden Sie das korrekte Format in eckigen Klammern für jedes Metafeld.
- Vermeiden Sie das Überschreiben wichtiger Daten - entfernen Sie Spalten für Felder, die Sie nicht ändern möchten.
- Verwenden Sie den Export, um Ihre aktuellen Metafelder zu sichern, bevor Sie Änderungen vornehmen.
Metafelder sind eine leistungsstarke Möglichkeit, die Funktionalität Ihres Shopify-Shops zu erweitern. Mit DataEase können Sie sie effizient verwalten - in großen Mengen - und ohne Code schreiben zu müssen.
Zusätzliche Felder
Section titled “Zusätzliche Felder”Weitere Spalten, die DataEase für diese Entität unterstützt:
accessAdmin— Admin-Zugriffsebene für die Metafeld-Definition. Gilt nur für App-Namensräume (siehe Eigentümertypen und Zugriff oben).accessCustomer— Kunden-Zugriffsebene für die Metafeld-Definition.accessStoreFront— Storefront-Zugriffsebene für die Metafeld-Definition.capabilitiesAdminFilterableEnabled— Gibt an, ob die Admin-Filterung für das Metafeld aktiviert ist.capabilitiesAdminFilterableEligible— Berechtigungsstatus für die Admin-Filterfähigkeit.capabilitiesAdminFilterableStatus— Aktueller Status der Admin-Filterfähigkeit.capabilitiesSmartCollectionConditionEnabled— Gibt an, ob die Bedingung für die intelligente Sammlung für das Metafeld aktiviert ist.capabilitiesSmartCollectionConditionEligible— Berechtigungsstatus für die Bedingung der intelligenten Sammlung.capabilitiesUniqueValuesEnabled— Gibt an, ob eindeutige Werte für das Metafeld aktiviert sind.capabilitiesUniqueValuesEligible— Berechtigungsstatus für die Fähigkeit eindeutiger Werte.capabilitiesAnalyticsQueryableEnabled—true, damit das Metafeld in ShopifyQL-Analysen verwendet werden kann. Importierbar (true/false); Shop-Transfers übernehmen es, wenn es im Quellshop aktiviert ist.capabilitiesAnalyticsQueryableEligible— Ob die Definition die Analyse-Funktion nutzen kann. Nur Export.capabilitiesCartToOrderCopyableEnabled—true, um den Wert von der Warenkorbzeile in die Bestellposition zu kopieren. Importierbar (true/false); Shop-Transfers übernehmen es, wenn es im Quellshop aktiviert ist.capabilitiesCartToOrderCopyableEligible— Ob die Definition das Kopieren vom Warenkorb in die Bestellung nutzen kann. Nur Export.constraintsKey— Einschränkungen, die auf den Metafeld-Schlüssel angewendet werden.constraintsValues— Einschränkungen, die auf die Metafeld-Werte angewendet werden.metafieldsCount— Anzahl der mit der Definition verknüpften Metafelder.pinnedPosition— Gibt an, ob das Metafeld im Admin angeheftet ist.metafieldsValidationStatus— Validierungsstatus der Metafelder.category— Kategorie der Metafeld-Definition.description— Beschreibung der Metafeld-Definition.key— Schlüssel für die Metafeld-Definition.name— Name der Metafeld-Definition.namespace— Namespace für die Metafeld-Definition.ownerType— Typ des Eigentümers, der mit der Metafeld-Definition verknüpft ist (zum BeispielPRODUCT,CUSTOMER,TRANSFER).type— Datentyp der Metafeld-Definition.validations— JSON-Array von Validierungen für die Metafeld-Definition.deleteAssociatedMetafields— Gibt an, ob verknüpfte Metafelder gelöscht werden sollen.