Corriger les erreurs d’import des métachamps produit Shopify

Les imports de métachamps échouent souvent pour trois raisons : mauvaise définition, valeur incompatible avec son type ou ligne produit sans les colonnes nécessaires.

Erreur Shopify : Validation failed: Value must be a valid product reference

Shopify affiche ce message lorsqu’un métachamp de référence produit pointe vers un produit qui n’existe pas encore dans la boutique. Importez ou créez d’abord les produits référencés, puis réimportez les valeurs de métachamps. Shopify répertorie ce message exact dans son guide de dépannage des imports CSV produit.

Corriger namespace et key

Chaque en-tête doit devenir product.metafields.<namespace>.<key>. Utilisez uniquement lettres, chiffres, tirets et tirets bas et respectez les limites de longueur.

Corriger les valeurs selon leur type

Booléens, dates, nombres, URL et mesures doivent respecter le format du type choisi. Les listes sont séparées par des points-virgules et doivent rester sous leur limite d’éléments.

Si Shopify signale une règle supplémentaire, vérifiez la définition dans la boutique : choix, regex et min/max personnalisés ne sont pas présents dans le CSV.

Vérifier les colonnes produit et les destinations dupliquées

Pour les mises à jour, conservez Title et URL handle (ou Handle compatible). Deux colonnes source ne doivent pas viser le même en-tête de sortie.

Relancer le contrôle après correction

Le preflight parcourt tout le fichier et conserve des totaux exacts. Téléchargez un nouveau CSV seulement quand les erreurs bloquantes ont disparu.

Corriger le CSV de métachamps Shopify

Voir la transformation

Les en-têtes maladroits deviennent des colonnes prêtes à importer.

Renommez les colonnes nécessaires tout en gardant chaque valeur sous le bon en-tête.

cust_idcustomer_id

given_namefirst_name

mailemail

✓ Les valeurs restent dans la bonne colonne