Catalog Precheck
Guides
V001

Shopify CSV « Échec de la validation : les options ne sont pas uniques » : comment y remédier

Recherchez deux lignes de variantes avec la même combinaison de valeurs Option1–3 sous une seule poignée de produit. Ne modifiez pas chaque poignée répétée : les variantes d’un produit la partagent normalement.

Définition de la règle

Les variantes sous un même identifiant répètent la même combinaison d'options.

Critique

Limites de la correction automatique: Cette règle nécessite une vérification manuelle ; les données métier ne sont pas modifiées automatiquement.

Ne pas inventer une nouvelle valeur d'option
Si ce CSV met à jour un produit existant, la modification d'une valeur d'option peut créer de nouveaux ID de variante et affecter les applications qui en dépendent. Confirmez la variante prévue dans votre boutique avant de la modifier.

Signification de l'erreur

Shopify indique que le fichier peut contenir des options en double pour un produit, ou que le même produit peut apparaître ailleurs sous le même identifiant. Comparez la combinaison complète d’options, pas seulement une cellule de taille ou de couleur. Des handles répétés sont attendus sur les lignes de variantes authentiques.

Deux lignes, une valeur de taille

Les deux lignes ci-dessous appartiennent au té de poignée et correspondent à la combinaison d'options Taille : M. Sur un écran étroit, faites défiler le bloc de code latéralement pour afficher toutes les colonnes.

Invalide : combinaison d'options en double
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,M

La règle V001 marque les deux lignes métier. Un nom Title et Option1 vide sur une ligne de suite ne fait pas de M une variante différente.

Correction d'illustration : deux tailles distinctes
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,L

Utilisez L uniquement si la deuxième ligne décrit réellement la taille L. Sinon, supprimez une ligne réellement en double ou corrigez le mappage du produit après avoir vérifié les données sources.

Comment enquêter en toute sécurité

  1. 01

    Conservez le CSV d'origine. Regroupez les lignes par identifiant d'URL, puis comparez chaque valeur Option1, Option2 et Option3 non vide dans chaque produit.

  2. 02

    Vérifiez si les lignes répétées sont des variantes prévues distinctes, des lignes de produits en double accidentelles ou des lignes de continuation contenant uniquement des images. Une poignée répétée ne constitue pas à elle seule une raison pour renommer un produit.

  3. 03

    Corrigez l'erreur de source réelle : donnez à une variante réelle sa vraie valeur d'option, supprimez uniquement un doublon confirmé ou utilisez le bon handle s'il appartient à un autre produit.

  4. 04

    Exécutez à nouveau la vérification locale, examinez les autres résultats et vérifiez toute modification apportée aux variantes existantes dans Shopify avant l'importation.

Rechercher les combinaisons en double localement

La règle de prévérification du catalogue V001 signale les combinaisons Option1–3 non vides répétées sous le même handle. Il ignore les lignes contenant uniquement des images. Il ne peut pas décider quelle ligne est correcte ni voir les variantes déjà présentes dans votre boutique. Le retour ouvre un nouveau validateur ; le fichier précédemment sélectionné n'est pas conservé.
Vérifier mon CSVVoir la règle V001
Ce qui reste incertain
Une analyse propre au niveau du fichier ne prouve pas que le CSV correspond aux variantes Shopify existantes ou que l'importation réussira. Vérifiez les ID de produit et de variante prévus avant de modifier les options d'un produit existant.

Sources vérifiées : 28 septembre 2026. Shopify : problèmes d'importation courants · Shopify : options du produit CSV et ID de variante

Catalog Precheck est un outil indépendant et n'est pas affilié à Shopify.