Skuvera

Corrigez l'erreur “Validation failed: Value must be a valid product reference” lors d'un import CSV dans Shopify

Un métachamp de votre CSV fait référence à un produit qui n'est pas encore dans votre boutique. Importez d'abord les produits sans ces valeurs de métachamp, puis remettez les valeurs et importez à nouveau avec “Overwrite products with matching handles” coché.

Message d'erreur dans Shopify

Validation failed: Value must be a valid product reference

Signification de cette erreur

Certains métachamps, comme les produits associés ou complémentaires, stockent une référence vers un autre produit. Shopify n'accepte qu'une référence vers un produit qui existe déjà dans votre boutique. Quand le produit référencé est créé par le même CSV, ou n'existe pas du tout, l'import échoue avec cette erreur.

Causes fréquentes

  • Le produit référencé est dans le même fichier et n'a pas encore été créé quand Shopify vérifie la référence.
  • Le produit référencé a été supprimé de votre boutique.
  • La valeur de référence contient une faute de frappe ou ne correspond à aucun produit existant.

Comment corriger

  1. Enregistrez une copie de votre fichier, pour conserver les valeurs de métachamps.
  2. Dans le fichier que vous importez, retirez les valeurs des colonnes de métachamps de référence produit.
  3. Importez le fichier. Tous les produits sont créés sans les références.
  4. Rétablissez les valeurs de métachamps dans votre CSV.
  5. Importez à nouveau avec “Overwrite products with matching handles” coché. Chaque produit référencé existe désormais, donc les références sont acceptées.

Comment l'éviter

  • Importez les nouveaux produits avant tout fichier qui s'y réfère.
  • Planifiez les imports avec références en deux étapes, comme le recommande Shopify.

Vérifiez le reste de votre fichier

Skuvera ne peut pas détecter ce problème précis avant l'import, mais il vérifie votre CSV produit selon les autres règles de Shopify dans votre navigateur, pour corriger tout le reste en une fois. Gratuit, sans inscription.

Foire aux questions

Pourquoi dois-je importer deux fois ?
Shopify vérifie chaque référence au moment d'importer le produit. Un produit créé plus loin dans le même fichier n'existe pas encore à cet instant, donc le premier import crée les produits et le second ajoute les références.
L'option d'écrasement modifie-t-elle d'autres données ?
Elle remplace les valeurs des colonnes présentes dans votre CSV pour les produits au handle correspondant. Les colonnes absentes du fichier conservent leurs valeurs actuelles.

En savoir plus

Lire l'explication de Shopify

Autres erreurs d'import

Mis à jour le 30 octobre 2026