Corrigez l'erreur “Ignored line because handle already exists” lors d'un import CSV dans Shopify

Shopify a ignoré la ligne parce que son URL handle était déjà utilisé par un produit précédent du fichier. Gardez toutes les lignes d'un produit groupées, l'une après l'autre, et veillez à ce que deux produits différents ne partagent jamais le même handle.

Message d'erreur dans Shopify

Ignored line #-## because handle example already exists

Signification de cette erreur

Le URL handle identifie chaque produit de manière unique. Shopify lit les lignes de haut en bas et regroupe les lignes consécutives portant le même handle en un seul produit. Si le même handle réapparaît après un autre produit, ou si un deuxième produit commence avec un handle déjà utilisé, Shopify ignore ces lignes.

Causes fréquentes

  • Le fichier a été trié dans un tableur selon une colonne autre que URL handle, ce qui a séparé les lignes d'un produit.
  • Deux produits différents ont reçu le même handle, souvent parce que leurs titres sont semblables.
  • Des lignes de plusieurs exports ont été fusionnées, si bien que le même produit apparaît deux fois.

Comment corriger

  1. Cherchez le handle mentionné dans le message d'erreur.
  2. Recherchez dans le fichier toutes les lignes portant ce handle.
  3. Si les lignes appartiennent à un seul produit, déplacez-les pour qu'elles se suivent directement.
  4. Si elles appartiennent à des produits différents, donnez à l'un des deux un nouveau URL handle unique, en lettres minuscules, chiffres et tirets.
  5. Si le même produit apparaît deux fois, supprimez les lignes en doublon.
  6. Enregistrez le fichier en CSV UTF-8 et importez-le à nouveau.

Exemple

Avant
URL handle,Title,Option1 name,Option1 value,Price
cotton-tee,Cotton tee,Size,S,25.00
linen-shirt,Linen shirt,Size,S,39.00
cotton-tee,,,M,25.00
Après
URL handle,Title,Option1 name,Option1 value,Price
cotton-tee,Cotton tee,Size,S,25.00
cotton-tee,,,M,25.00
linen-shirt,Linen shirt,Size,S,39.00

La ligne taille M de cotton-tee venait après linen-shirt, donc Shopify l'a ignorée. La placer juste sous la première ligne cotton-tee corrige l'import.

Comment l'éviter

  • Ne triez pas un CSV produit dans un tableur. Shopify avertit que le tri peut aussi détacher les images de leurs produits.
  • Vérifiez l'absence de handles répétés avant l'import, surtout après une fusion de fichiers.

Détectez ce problème avant l'import

Skuvera vérifie votre CSV produit selon toutes les règles de Shopify dans votre navigateur et indique la ligne et la colonne exactes. Gratuit, sans inscription.

Foire aux questions

Cette erreur signifie-t-elle que mon produit existant a été modifié ?
Non. Les lignes ont été ignorées, donc rien n'en a été importé. Corrigez le fichier et importez de nouveau ces produits.
Que fait l'option “Overwrite products with matching handles” ?
Quand elle est cochée, les produits du CSV remplacent les produits existants de votre boutique qui ont le même handle. Elle ne corrige pas les handles en doublon à l'intérieur du fichier lui-même.

Vérifications associées dans Skuvera

Lire l'explication de Shopify

Autres erreurs d'import

Mis à jour le 30 octobre 2026