Handle, SKU, Compare At Price, Variant ID... Décryptez le rôle de chaque colonne Shopify, les pièges sournois à éviter et les bonnes pratiques indispensables.
Identité
Handle (Identifiant produit)
L'identifiant URL unique et clé primaire d'un produit dans Shopify.
En détail
Le Handle est la chaîne unique que Shopify utilise pour identifier un produit et construire son lien web public (ex: maboutique.com/products/t-shirt-coton-bio). Dans le CSV, c'est la clé maîtresse qui relie toutes les variantes à un même produit.
Pourquoi c'est crucial dans Shopify
Shopify s'appuie sur le Handle et non sur le titre pour reconnaître un produit. Si vous modifiez le Handle, Shopify créera un produit doublon au lieu de mettre à jour la fiche existante.
Piège classique à éviter
Modifier le titre d'un produit dans Excel avec une formule qui régénère un nouveau Handle scinde le produit et crée des doublons.
Exemple de valeur
t-shirt-coton-bio
Stock
SKU (Référence stock)
La référence interne unique attribuée à une variante précise en stock.
En détail
Le SKU (Stock Keeping Unit) est un code alphanumérique unique attribué à chaque variante physique (taille, couleur) pour la gestion logistique et le suivi d'entrepôt.
Pourquoi c'est crucial dans Shopify
Contrairement au Handle qui identifie le produit global, le SKU doit être unique par déclinaison. Attribuer le même SKU à deux produits différents crée des erreurs d'expédition.
Piège classique à éviter
Confondre Handle et SKU en copiant le SKU dans la colonne Handle, ce qui éclate les variantes en plusieurs fiches séparées.
Exemple de valeur
TSHIRT-NOIR-M
Prix
Compare At Price (Prix barré)
Le prix de référence affiché barré avant promotion ou solde.
En détail
Dans le CSV Shopify, "Variant Compare At Price" correspond au prix d'origine avant réduction. La colonne "Variant Price" correspond au prix effectivement payé par le client.
Pourquoi c'est crucial dans Shopify
Si le prix barré est inférieur au prix de vente normal, l'affichage promo devient incohérent (rabais négatif).
Piège classique à éviter
Inverser les colonnes de prix lors d'une formule de calcul dans Excel, ce qui augmente le prix soldé au lieu de le baisser.
Exemple de valeur
Variant Price: 29.99 | Variant Compare At Price: 39.99
Identité
Variante & Options
Une déclinaison précise d'un produit (ex: Taille M / Noir).
En détail
Une variante représente une version achetable d'un produit. Chaque variante a sa propre ligne dans le CSV, partage le même Handle, mais possède des options (Option1, Option2), un SKU, un prix et un stock distincts.
Pourquoi c'est crucial dans Shopify
Toutes les variantes d'un même produit doivent obligatoirement se suivre consécutivement sous le même Handle dans le fichier CSV.
Piège classique à éviter
Oublier de renseigner le Handle sur les lignes de variantes secondaires, ce qui empêche Shopify de les rattacher au produit.
Exemple de valeur
Option1: Taille = M, Option2: Couleur = Noir
Médias
Image Src (URL de l'image)
Le lien web direct (URL HTTPS) hébergeant la photo du produit.
En détail
La colonne Image Src contient l'adresse web complète hébergeant la photo (ex: sur le CDN Shopify). Les images additionnelles d'un produit occupent des lignes supplémentaires avec le même Handle.
Pourquoi c'est crucial dans Shopify
Si vous supprimez cette colonne dans Excel et réimportez avec l'option "Remplacer les produits", Shopify peut effacer toutes les photos de vos fiches !
Piège classique à éviter
Supprimer la colonne Image Src pour alléger le fichier Excel alors qu'on voulait seulement ajuster les prix.
La quantité en stock disponible pour la variante sur votre boutique.
En détail
Quantité numérique en stock. Lors d'un import, Shopify écrase immédiatement l'inventaire actuel par le chiffre figurant dans cette colonne.
Pourquoi c'est crucial dans Shopify
Réimporter un CSV exporté il y a quelques jours écrase toutes les commandes passées entre-temps et remet les anciens stocks obsolètes.
Piège classique à éviter
Laisser la cellule de stock vide ou y mettre du texte, ce qui force le stock à 0 dans Shopify.
Exemple de valeur
45 (nombre entier positif)
Général
Lignes non contiguës
Lignes d'un même produit dispersées et séparées par d'autres produits.
En détail
Dans un CSV Shopify, toutes les lignes appartenant à un même produit (même Handle) doivent obligatoirement se suivre les unes après les autres de manière contiguë.
Pourquoi c'est crucial dans Shopify
Si les lignes d'un même Handle sont dispersées (ex: ligne 2 et ligne 50), Shopify n'arrive pas à les fusionner et crée des fiches distinctes en double.
Piège classique à éviter
Trier le fichier par prix ou par SKU avant d'enregistrer, ce qui disperse les variantes dans tout le classeur.
Exemple de valeur
Lignes 2 à 4 : Variantes Produit A. Lignes 5 à 6 : Variantes Produit B.
Général
CSV candidat (À importer)
Le nouveau fichier CSV modifié que vous prévoyez d'importer dans Shopify.
En détail
Il s'agit du fichier préparé dans Excel, reçu d'un fournisseur ou généré par un outil, qui doit être vérifié avant d'être appliqué sur votre boutique en direct.
Pourquoi c'est crucial dans Shopify
Validify analyse ce fichier pour intercepter toute anomalie avant qu'elle n'affecte vos clients ou votre chiffre d'affaires.
Piège classique à éviter
Importer directement le fichier fournisseur sans vérifier s'il respecte la structure officielle Shopify.
Exemple de valeur
nouveaux_tarifs_2026.csv
Général
Catalogue actuel (Référence)
L'export de sauvegarde récent téléchargé depuis votre administration Shopify.
En détail
Export réalisé depuis Produits > Exporter dans Shopify Admin. Il représente l'état exact et fiable de votre boutique en direct.
Pourquoi c'est crucial dans Shopify
Il permet à Validify d'effectuer une comparaison différentielle pour détecter les baisses de prix suspectes, les stocks écrasés ou les variantes supprimées.
Piège classique à éviter
Utiliser un export datant de plusieurs semaines plutôt que de télécharger une sauvegarde juste avant l'import.
Exemple de valeur
export_shopify_reference.csv
Vous avez un doute sur vos colonnes Shopify ?
Importez votre catalogue dans Validify : notre algorithme vérifie immédiatement la conformité de chaque colonne et vous alerte avant Shopify.
