Skuvera

„Validation failed: Value must be a valid product reference“ bei einem Shopify-CSV-Import beheben

Ein Metafeld in Ihrer CSV verweist auf ein Produkt, das noch nicht in Ihrem Shop existiert. Importieren Sie zuerst die Produkte ohne diese Metafeld-Werte, ergänzen Sie dann die Werte wieder und importieren Sie erneut mit ausgewählter Option „Overwrite products with matching handles“.

Fehlermeldung in Shopify

Validation failed: Value must be a valid product reference

Was dieser Fehler bedeutet

Manche Metafelder, etwa für verwandte oder ergänzende Produkte, speichern einen Verweis auf ein anderes Produkt. Shopify akzeptiert nur einen Verweis auf ein Produkt, das bereits in Ihrem Shop existiert. Wird das referenzierte Produkt von derselben CSV angelegt oder existiert es gar nicht, schlägt der Import mit diesem Fehler fehl.

Häufige Ursachen

  • Das referenzierte Produkt liegt in derselben Datei und existiert noch nicht, wenn Shopify den Verweis prüft.
  • Das referenzierte Produkt wurde aus Ihrem Shop gelöscht.
  • Der Verweiswert enthält einen Tippfehler oder passt zu keinem bestehenden Produkt.

So wird es behoben

  1. Speichern Sie eine Kopie Ihrer Datei, damit Sie die Metafeld-Werte behalten.
  2. Entfernen Sie in der zu importierenden Datei die Werte aus den Metafeld-Spalten für Produktverweise.
  3. Importieren Sie die Datei. Alle Produkte werden ohne die Verweise angelegt.
  4. Stellen Sie die Metafeld-Werte in Ihrer CSV wieder her.
  5. Importieren Sie erneut mit ausgewählter Option „Overwrite products with matching handles“. Jetzt existiert jedes referenzierte Produkt, sodass die Verweise akzeptiert werden.

So vermeiden Sie es

  • Importieren Sie neue Produkte vor jeder Datei, die auf sie verweist.
  • Planen Sie Importe mit Verweisen von vornherein in zwei Schritten, wie Shopify es empfiehlt.

Prüfen Sie den Rest Ihrer Datei

Skuvera erkennt dieses spezielle Problem vor dem Import nicht, prüft Ihre Produkt-CSV in Ihrem Browser aber gegen die übrigen Shopify-Regeln, damit Sie alles andere auf einmal beheben. Kostenlos, keine Registrierung.

Häufig gestellte Fragen

Warum muss ich zweimal importieren?
Shopify prüft jeden Verweis, wenn es das Produkt importiert. Ein Produkt, das später in derselben Datei angelegt wird, existiert in diesem Moment noch nicht; der erste Import legt daher die Produkte an und der zweite ergänzt die Verweise.
Ändert die Überschreib-Option andere Daten?
Sie ersetzt die Werte der Spalten aus Ihrer CSV für Produkte mit passendem Handle. Spalten, die nicht in der Datei enthalten sind, behalten ihre aktuellen Werte.

Mehr erfahren

Shopifys Erklärung lesen

Weitere Importfehler

Aktualisiert am 30. Oktober 2026