Shopify-Metafeld-CSV-Importfehler beheben

Metafeldimporte scheitern häufig an drei Dingen: Die CSV verweist auf die falsche Definition, ein Wert passt nicht zum Typ oder die Produktzeile enthält nicht die nötigen Identifikationsspalten.

Shopify-Fehler: Validation failed: Value must be a valid product reference

Shopify zeigt diese Meldung an, wenn ein Produktreferenz-Metafeld auf ein Produkt verweist, das im Shop noch nicht existiert. Importieren oder erstellen Sie zuerst die referenzierten Produkte und importieren Sie danach die Metafeldwerte erneut. Shopify führt die exakte Meldung in seiner Fehlerbehebung für Produkt-CSV-Importe auf.

Namespace- und Key-Fehler beheben

Jede Metafeldüberschrift muss zu product.metafields.<namespace>.<key> werden. Verwende nur Buchstaben, Zahlen, Bindestriche und Unterstriche und halte die Längenregeln ein.

Wertetypen korrigieren

Boolean-, Datums-, Zahlen-, URL- und Maßeinträge müssen zum ausgewählten Shopify-Typ passen. Listen werden mit Semikolon getrennt und dürfen das dokumentierte Eintragslimit nicht überschreiten.

Meldet Shopify eine zusätzliche Regel, prüfe die Metafelddefinition im Shop. Eigene Auswahlwerte, Regex oder Min/Max-Regeln kann eine lokale CSV nicht enthalten.

Produktspalten und doppelte Ziele prüfen

Für Aktualisierungen sollten Title und URL handle (oder kompatibel Handle) im Ergebnis bleiben. Zwei Quellspalten dürfen nicht dieselbe Zielüberschrift erhalten.

Nach jeder Korrektur erneut prüfen

Der Preflight liest die vollständige Datei und zählt alle Probleme, auch wenn die sichtbare Liste begrenzt ist. Lade erst nach einem fehlerfreien Durchlauf eine neue Shopify-CSV herunter.

Shopify-Metafeld-CSV reparieren

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