Shopify-Metafeld-CSV-Format: Namespace, Key und Typen

Shopify-Produktmetafelder haben keine feste Spaltenliste. Jedes Metafeld wird zu einer dynamischen CSV-Überschrift, deren Namespace und Key die Definition bestimmen.

Das Format der Metafeldüberschrift

Die kanonische Form lautet product.metafields.<namespace>.<key>. Exporte können zusätzlich einen lesbaren Namen enthalten. Für einen vorbereiteten Import reicht die kanonische Überschrift.

Namespace und Key erlauben Buchstaben, Zahlen, Bindestriche und Unterstriche. Der Namespace hat 2–255 Zeichen, der Key 2–64. Nablyx nimmt namespace.key entgegen und erzeugt daraus die vollständige Überschrift.

Typ muss zur Definition passen

Der Produkt-CSV-Import unterstützt unter anderem Boolean, Farbe, Datum/Datum-Zeit, Maße, Geld, Dezimal- und Ganzzahlen, Produktreferenzen, Text, URL, Volumen und Gewicht sowie mehrere Listentypen. Der Typ steht nicht in der CSV-Überschrift; die Shopify-Definition ist maßgeblich.

Listen mit Semikolon trennen

Unterstützte Listenwerte werden mit Semikolon getrennt. Für die meisten Listentypen gilt ein dokumentiertes Maximum von 128 Einträgen; Metaobjekt-Referenzlisten haben ein höheres Limit.

Nur prüfbare Regeln lokal validieren

Eine eigenständige CSV enthält keine shopspezifischen Definitionsregeln. Der lokale Preflight prüft daher das öffentliche Schema, während individuelle Auswahlwerte, Regex oder andere Regeln weiterhin in Shopify geprüft werden müssen.

Shopify-Metafeldformat prüfen

Transformation ansehen

Unhandliche Quellspalten werden importbereit.

Benennen Sie die benötigten Spalten um, während jeder Wert unter der richtigen Überschrift bleibt.

cust_idcustomer_id

given_namefirst_name

mailemail

✓ Werte bleiben in der richtigen Spalte