Import CSV Shopify : comment transférer ses produits

Shopify propose nativement un import de produits par fichier CSV. C'est la méthode la plus accessible pour transférer un catalogue, mais aussi celle qui génère le plus d'erreurs quand on ne connaît pas ses contraintes. Ce guide couvre la structure exacte du fichier attendu, la logique des variantes, et les erreurs récurrentes qui font échouer les imports.

La structure du fichier CSV Shopify

Télécharger le template officiel

Avant de commencer, télécharger le template depuis le back-office Shopify : Produits > Importer > Télécharger un exemple de fichier CSV. Ce fichier contient une ligne d'exemple avec toutes les colonnes disponibles. Il est essentiel de partir de ce template plutôt que de construire un fichier de zéro — Shopify est strict sur les noms de colonnes (sensibles à la casse et aux espaces).

Colonnes obligatoires

Colonne	Type	Description
Handle	Texte	Identifiant unique du produit (slug URL, minuscules, tirets)
Title	Texte	Nom du produit
Body (HTML)	HTML	Description du produit
Vendor	Texte	Fournisseur ou marque
Product Category	Texte	Catégorie Shopify (taxonomie officielle)
Type	Texte	Type de produit personnalisé
Tags	Texte	Tags séparés par des virgules
Published	Booléen	TRUE ou FALSE
Variant SKU	Texte	Référence de la variante
Variant Price	Décimal	Prix HT ou TTC selon la config boutique
Image Src	URL	URL complète et accessible de l'image

Colonnes importantes mais non bloquantes

• Variant Compare At Price : prix barré (pour les promotions)
• Variant Inventory Qty : quantité en stock (nécessite Variant Inventory Policy = deny ou continue)
• Variant Weight : poids pour le calcul de frais de port
• Variant Barcode : EAN-13, UPC ou autre code-barres
• SEO Title, SEO Description : balises meta pour le référencement
• Image Position : ordre des images (1, 2, 3…)
• Image Alt Text : texte alternatif pour l'accessibilité et le SEO

La logique des variantes : le point le plus difficile

Un produit = plusieurs lignes

C'est la règle qui génère le plus de confusion. Dans le CSV Shopify, chaque variante d'un produit occupe une ligne séparée. La première ligne d'un produit contient toutes les informations générales (titre, description, images principales, etc.). Les lignes suivantes pour le même produit ne répètent que les informations spécifiques à chaque variante.

Exemple : T-shirt avec 3 tailles

Handle,Title,Body (HTML),Vendor,Tags,Published,Option1 Name,Option1 Value,Variant SKU,Variant Price,Image Src
t-shirt-basic,"T-Shirt Basic","<p>T-shirt en coton bio.</p>",Ma Marque,"coton,basique",TRUE,Taille,S,TSH-S,29.90,https://cdn.monshop.com/tshirt-basic.jpg
t-shirt-basic,,,,,,Taille,M,TSH-M,29.90,
t-shirt-basic,,,,,,Taille,L,TSH-L,29.90,

Points critiques :

• Le Handle doit être identique sur toutes les lignes du même produit
• La deuxième ligne et suivantes laissent Title, Body (HTML), Image Src vides
• Shopify reconstitue le produit à partir du Handle commun

Si le Handle est vide ou différent sur une ligne de variante, Shopify crée un nouveau produit au lieu d'une variante du produit existant. C'est l'erreur la plus fréquente sur les gros imports.

Plusieurs options de variantes

Shopify supporte jusqu'à 3 options de variantes par produit (Option1, Option2, Option3). Pour un produit avec Couleur + Taille :

Handle,Title,Option1 Name,Option1 Value,Option2 Name,Option2 Value,Variant SKU,Variant Price
pull-laine,"Pull en laine",Couleur,Bleu marine,Taille,S,PL-BM-S,89.90
pull-laine,,Couleur,Bleu marine,Taille,M,PL-BM-M,89.90
pull-laine,,Couleur,Ecru,Taille,S,PL-EC-S,89.90
pull-laine,,Couleur,Ecru,Taille,M,PL-EC-M,89.90

4 variantes pour 2 couleurs × 2 tailles = 4 lignes dans le fichier.

Les images : URL accessibles uniquement

Ce que Shopify accepte

Shopify télécharge les images depuis les URLs fournies dans Image Src au moment de l'import. Ces URLs doivent être :

• Accessibles publiquement — pas de login requis, pas de restriction IP
• Permanentes pendant la durée de l'import — si l'URL devient inaccessible avant que Shopify ne l'ait téléchargée, l'image est ignorée sans erreur bloquante
• En HTTPS — les URLs HTTP peuvent être refusées selon la configuration

Pour une migration depuis PrestaShop, les images sont typiquement accessibles via https://monanciensite.com/img/p/1/2/3/123-large.jpg. Si l'ancien site reste en ligne pendant la migration, ces URLs fonctionnent directement. Si le serveur PrestaShop est coupé avant l'import, les images doivent être hébergées temporairement ailleurs (un bucket S3 ou un CDN temporaire).

Plusieurs images par produit

Chaque image supplémentaire occupe une ligne dans le CSV :

Handle,Title,Image Src,Image Position
pull-laine,"Pull en laine",https://cdn.example.com/pull-face.jpg,1
pull-laine,,https://cdn.example.com/pull-dos.jpg,2
pull-laine,,https://cdn.example.com/pull-detail.jpg,3

Image Position détermine l'ordre d'affichage. La ligne avec Image Position = 1 sert d'image principale.

La limite de 15 Mo et les alternatives

Le fichier CSV uploadé via l'interface Shopify est limité à 15 Mo. Pour un catalogue de 5 000 produits avec des descriptions longues, cette limite est rapidement atteinte.

Découpage en sous-fichiers

La solution de base consiste à découper le catalogue en plusieurs fichiers de moins de 15 Mo et à les importer successivement. Les Handles étant uniques par produit, il n'y a pas de risque de doublons si la même référence apparaît dans deux fichiers — Shopify mettra à jour le produit existant plutôt que d'en créer un second.

Matrixify pour les gros catalogues

Matrixify (anciennement Excelify) est l'outil de référence pour les imports complexes sur Shopify. Il dépasse les limites du CSV natif :

• Pas de limite de taille de fichier (traitement par batch automatique)
• Support des métafields dans le fichier d'import
• Import des collections en même temps que les produits
• Rapports d'erreurs détaillés avec numéro de ligne
• Import depuis Google Sheets directement

Tarif : à partir de 20 $/mois pour le plan qui débloque l'import produits complet. Indispensable pour les catalogues de plus de 5 000 références.

Erreurs classiques et comment les corriger

Erreur : "Duplicate Handle"

Cause : deux produits différents ont le même Handle dans le fichier. Le Handle doit être unique sur toute la boutique.

Correction : vérifier les doublons avec =COUNTIF($A:$A,A2)>1 dans Excel ou LibreOffice Calc. Renommer les Handles en conflit.

Erreur : variantes créées comme produits séparés

Cause : le Handle est vide ou différent sur les lignes de variantes.

Correction : vérifier que chaque ligne de variante a exactement le même Handle que la ligne produit parente. Un espace invisible ou une majuscule suffit à casser la relation.

Erreur : images non importées (sans message d'erreur)

Cause : les URLs d'images retournent une erreur 404 ou sont protégées.

Correction : tester chaque URL dans un navigateur avant l'import. Sur un grand catalogue, un script simple peut vérifier les codes HTTP de toutes les URLs en quelques minutes.

Erreur : caractères spéciaux corrompus

Cause : le fichier CSV n'est pas encodé en UTF-8.

Correction : ouvrir le fichier source dans un éditeur de texte (VS Code, Notepad++), vérifier l'encodage dans la barre de statut, et le sauvegarder explicitement en UTF-8 sans BOM.

Erreur : prix importés avec virgule décimale

Cause : sur les systèmes en langue française, Excel exporte les décimaux avec une virgule (29,90) alors que Shopify attend un point (29.90).

Correction : dans Excel, utiliser Rechercher/Remplacer sur la colonne prix pour remplacer , par ., ou configurer les paramètres régionaux avant l'export.

WarpForge : contourner le CSV complètement

L'import CSV a des avantages — il est gratuit et ne nécessite aucun outil tiers pour les petits catalogues. Mais ses limites sont réelles : pas de gestion native des métafields, pas d'import des clients ou commandes, logique de variantes fragile, et pas de rapport d'erreur granulaire.

WarpForge contourne entièrement le CSV en utilisant l'API GraphQL de Shopify. La mutation productSet permet de créer ou mettre à jour des produits complets — avec leurs variantes, leurs images, leurs métafields et leurs associations de collections — en une seule opération. Pas de fichier intermédiaire, pas de limite de taille, pas de risque d'encodage.

Pour un catalogue PrestaShop de 10 000 références avec des déclinaisons complexes, WarpForge réduit la migration de plusieurs jours de préparation CSV à quelques heures de transfert automatisé.

Conclusion

L'import CSV Shopify est une solution viable pour les petits catalogues et les transferts ponctuels. Pour des migrations complètes depuis PrestaShop, les contraintes s'accumulent rapidement : gestion des variantes, limites de taille, images à héberger séparément, erreurs silencieuses sur les images. Bien préparer son fichier — encodage, structure des variantes, URLs d'images accessibles — réduit drastiquement les allers-retours. Pour les catalogues complexes ou volumineux, les outils spécialisés (Matrixify ou WarpForge) sont plus fiables que le CSV natif.