Remplir le fichier d'import du catalogue, colonne par colonne
Mis à jour le 19/10/2026
Chaque onglet et chaque colonne du fichier d'import des produits expliqués : ce qui est obligatoire, ce qu'il faut saisir, les listes de choix et les erreurs les plus fréquentes.
Le fichier d'import du catalogue vous permet de créer, modifier ou supprimer des produits en masse, dans un tableur. Ce guide passe en revue chaque onglet et chaque colonne : à quoi elle sert, si elle est obligatoire et ce qu'il faut y saisir.
Le fichier se télécharge depuis l'écran « Import massif », dans la partie « Produits » : « Télécharger le modèle » si votre boutique n'a pas encore de produit, sinon « Exporter tous les produits » ou « Télécharger un exemple ». Pour le déroulé complet de l'import, voyez aussi Importer ou exporter votre catalogue en masse.
Avant de commencer
- Créez d'abord vos options et leurs valeurs (taille, couleur…) : l'onglet Variantes n'accepte que des options et des valeurs qui existent déjà. Voyez Remplir le fichier d'import des options de produit.
- Déposez vos photos dans votre bibliothèque de fichiers, par exemple avec la partie « Images (archive .zip) » de l'écran « Import massif » : l'onglet Images désigne les photos par leur nom de fichier.
- Partez d'un fichier tout juste exporté. Un produit modifié sur le site après l'export vous sera signalé à l'analyse.
Comment le fichier est organisé
- Quatre onglets sont lus à l'import : Produits, Traductions, Variantes et Images.
- L'onglet « Aide à l'import » résume chaque colonne et donne les codes des types de produit. En bas, ses listes de choix rassemblent toutes les valeurs acceptées (types, catégories, oui / non, taux de TVA, langues, options, valeurs de chaque option, marques…). Cet onglet est seulement une aide : il est ignoré à l'import.
- Dans le fichier Excel, les colonnes à valeur imposée ont une liste déroulante : cliquez sur la cellule et choisissez la valeur. Une valeur hors liste est refusée par Excel.
- La première ligne de chaque onglet (les en-têtes) reste figée en haut quand vous faites défiler le fichier. Ne renommez pas les en-têtes : une colonne au nom inconnu est refusée.
- En CSV, vous recevez une archive .zip avec un fichier par onglet, sans listes déroulantes.
- Pour les nombres, la virgule et le point sont acceptés pour les décimales.
Le lien entre les onglets
Chaque ligne des onglets Traductions, Variantes et Images désigne un produit par l'une de ces deux colonnes :
- Identifiant produit à modifier : le numéro du produit dans votre boutique, rempli à l'export. Ne le modifiez pas. Laissez-le vide pour un produit à créer.
- Code nouveau produit : votre propre code. Il est indispensable pour un produit à créer, puisqu'il n'a pas encore d'identifiant. Utilisez exactement le même code dans les autres onglets.
L'onglet Produits
Une ligne par produit. Selon les réglages et les options de votre boutique, certaines colonnes peuvent être absentes de votre fichier.
- Identifiant produit à modifier — à ne pas modifier. Rempli à l'export, vide pour un produit à créer.
- Code nouveau produit — obligatoire pour créer un produit. 64 caractères au plus : lettres sans accent, chiffres, point, tiret, barre oblique ou souligné. Chaque code est unique : deux produits ne peuvent pas porter le même. Vous pouvez aussi ajouter un code à un produit existant.
- Type — obligatoire pour créer un produit. Le code du type, choisi dans la liste ; leur signification est en bas de l'onglet « Aide à l'import ». Le type d'un produit existant ne change pas. Les cartes cadeau, accès plateforme et noms de domaine ne s'importent pas : ils se gèrent dans leur fiche.
- Catégorie — obligatoire. Une catégorie de votre boutique, choisie dans la liste. Si deux catégories portent le même nom, la liste les distingue par leur numéro, sous la forme « #12 ».
- Actif — facultatif. oui : le produit est en vente sur la boutique ; non : il est masqué aux visiteurs.
- Indexé — facultatif. oui : la fiche est proposée aux moteurs de recherche ; non : elle est exclue de l'indexation.
- Utilise un stock — facultatif. oui : les quantités sont suivies (colonne Stock de l'onglet Variantes) ; non : vente sans limite de stock. Pour une prestation avec réservation, le stock n'est jamais suivi : ce sont les créneaux qui donnent les places.
- Stock unique — facultatif. oui : un seul stock pour toutes les combinaisons d'options du produit ; non : un stock par combinaison. Sans stock suivi ou sans options, ce réglage n'est pas retenu.
- Achat multiple — facultatif. oui : le client peut commander plusieurs exemplaires ; non : un seul par commande.
- Quantité min — sert quand l'achat multiple est activé. Nombre entier, 1 au minimum : la quantité minimale par commande, toutes combinaisons confondues.
- Quantité max — facultatif. Nombre entier de 1 à 500, au moins égal à la quantité min. Vide : pas de maximum.
- Catégorie fiscale — facultatif. Taux normal, Alimentation & première nécessité, Livres imprimés, Livres numériques, Presse ou Exonéré (0 %) : elle donne le taux de TVA du produit dans chaque pays de vente. Vide : catégorie inchangée (Taux normal pour un nouveau produit).
- TVA suivie du code d'un pays (par exemple « TVA FR ») — facultatif, pour un cas particulier seulement : un taux propre au produit dans ce pays, qui remplace celui de sa catégorie fiscale (par exemple 20, 5,5 ou 5.5). Vide : rien ne change.
- Marque — présente seulement si votre boutique a une liste des marques. Facultatif. Une valeur de cette liste, dans n'importe quelle langue. Une marque absente de la liste est refusée : ajoutez-la d'abord dans Infos produits › Listes de valeurs. Vide : la marque est retirée du produit.
- Ventes croisées — présente seulement avec l'option Ventes croisées. Facultatif. oui ou non : afficher les produits complémentaires sur la fiche.
- Format ventes croisées — même option. Facultatif. « ensemble » (souvent achetés ensemble) ou « reliés » (produits reliés).
- Barre livraison offerte — même option. Facultatif. oui ou non : afficher la barre de progression vers la livraison offerte.
- Produits complémentaires — même option. Facultatif. Les codes produit, ou les identifiants précédés de « # » (par exemple « #125 »), séparés par « ; », dans l'ordre d'affichage. Un produit créé dans le même fichier peut y figurer par son code. Vide : la liste est vidée.
- Supprimer — facultatif. « oui » pour supprimer le produit ; sinon laissez vide. C'est la seule façon de supprimer un produit par import.
- Version — à ne pas modifier. La date de dernière modification du produit au moment de l'export, qui permet de repérer un produit modifié sur le site depuis.
L'onglet Traductions
Une ligne par produit et par langue. Une cellule vidée efface le texte correspondant dans cette langue, sauf le slug, qui est alors recalculé à partir du nom.
- Identifiant produit à modifier ou Code nouveau produit — l'un des deux, pour désigner le produit.
- Langue — obligatoire. Une langue de votre boutique, choisie dans la liste. Un même produit ne peut avoir qu'une ligne par langue.
- Nom — obligatoire dans la langue principale de la boutique. 200 caractères au plus. Un produit à créer doit avoir une ligne dans la langue principale.
- Slug — facultatif. La fin de l'adresse de la fiche : lettres minuscules sans accent, chiffres et tirets, 200 caractères au plus. Il doit être unique dans votre boutique, toutes pages confondues (pages, catégories, produits, articles…). Vide : il est calculé à partir du nom.
- Meta titre — facultatif. Le titre proposé aux moteurs de recherche, 100 caractères au plus.
- Meta description — facultatif. Le résumé proposé aux moteurs de recherche, 200 caractères au plus.
- Description courte — facultatif. Le texte affiché près du prix, 5 000 caractères au plus.
- Description longue — facultatif. Du texte simple, sans mise en forme : séparez les paragraphes par une ligne vide. Si vous laissez ce texte tel qu'exporté, la description du site n'est pas modifiée et garde sa mise en forme. Si vous le modifiez, elle est remplacée par votre texte simple, à remettre en forme ensuite dans la fiche produit.
L'onglet Variantes
Une ligne par combinaison d'options, avec ses prix, son stock, son poids et ses références. Un produit sans option a une seule ligne, colonnes d'options vides.
- Identifiant produit à modifier ou Code nouveau produit — l'un des deux, pour désigner le produit.
- Option 1, Valeur 1, Option 2, Valeur 2… — obligatoires si le produit a des options. Le nom de l'option et sa valeur, en langue principale, choisis dans les listes. Le fichier prévoit une paire par option de votre boutique, et aucune si votre boutique n'a pas d'option. Choisissez d'abord l'option : la liste des valeurs ne propose alors que les valeurs de cette option.
- Prix HT suivi d'une devise (par exemple « Prix HT EUR ») — une colonne par devise de vente. Obligatoire pour un produit actif. Le prix hors taxes de la combinaison, supérieur à 0.
- Remise HT suivie de la devise — facultatif. Un montant déduit du prix HT, pas un pourcentage. Il ne peut pas dépasser le prix HT, qui doit être renseigné sur la même ligne.
- Stock — présente si un produit du fichier suit son stock (et toujours dans le modèle). Obligatoire si le produit suit son stock. La quantité disponible : un nombre entier positif.
- Alerte stock — présente seulement si votre offre comprend l'alerte de stock. Facultatif. Le seuil à partir duquel vous êtes alerté : un nombre entier positif.
- Poids (kg) — facultatif en général. Le poids en kilogrammes, 3 décimales au plus ; il sert au calcul des frais de port. Si vos frais de port sont calculés au poids, il est obligatoire pour un produit physique actif.
- SKU, EAN, MPN, Référence personnalisée — selon vos réglages. 64 caractères au plus. Seules les références activées dans les paramètres de votre boutique peuvent être remplies ; laissez les autres vides. Un produit actif doit avoir au moins une des références activées. L'EAN compte 8, 12, 13 ou 14 chiffres, avec une clé de contrôle exacte.
Les combinaisons
- Toutes les lignes d'un même produit utilisent les mêmes options, dans le même ordre.
- Toutes les associations de valeurs doivent être présentes : avec 2 tailles et 3 couleurs, il faut 6 lignes. Une combinaison ne peut pas figurer deux fois.
- Dès qu'un produit a des lignes dans cet onglet, ses combinaisons sont remplacées par celles du fichier. Un produit absent de l'onglet garde ses combinaisons.
- Une colonne retirée de l'onglet n'est pas modifiée : par exemple, sans colonne Stock, les stocks du site sont conservés.
- Un produit de type « Clé unique » ne peut pas avoir d'options.
L'onglet Images
Une ligne par photo.
- Identifiant produit à modifier ou Code nouveau produit — l'un des deux, pour désigner le produit.
- Position — l'ordre des photos : 1 pour la photo principale, puis 2, 3… Un nombre entier, 1 au minimum. Vide : la photo se range après les autres, dans l'ordre des lignes.
- Nom du fichier — obligatoire. Le nom exact de l'image dans votre bibliothèque de fichiers, par exemple « tasse-bleue.jpg ». Formats reconnus : jpg, jpeg, png, gif, webp et svg. Si plusieurs images portent le même nom, précisez l'extension, ou renommez-les.
Dès qu'un produit a des lignes dans cet onglet, ses photos sont remplacées par celles du fichier. Un produit absent de l'onglet garde ses photos.
Les erreurs les plus fréquentes
- « Produit actif incomplet » : un produit actif doit avoir un prix dans chaque devise pour chaque combinaison, au moins une des références activées, un stock s'il est suivi et un poids si vos frais de port sont calculés au poids. Complétez les onglets concernés, ou indiquez Actif = non.
- « Option inconnue » ou « Valeur inconnue » : l'option ou la valeur n'existe pas encore, ou son nom diffère de celui de la langue principale. Importez d'abord vos options.
- « Il manque des combinaisons » : il manque une association de valeurs pour ce produit.
- « Produit inconnu » : un produit à créer doit d'abord figurer dans l'onglet Produits, avec le même code nouveau produit que dans les autres onglets.
- Adresse déjà utilisée : deux produits du même nom obtiennent le même slug. Donnez à l'un d'eux un slug différent.
- « Image introuvable dans votre bibliothèque de fichiers » : le nom saisi ne correspond à aucune image de la bibliothèque. Vérifiez l'orthographe et déposez l'image d'abord.
- « Colonne inconnue » : un en-tête a été renommé ou ajouté. Reprenez les en-têtes d'origine.
- Nombre de produits : l'import est refusé si le nombre de produits après import dépasse celui autorisé par votre abonnement.
Renvoyer le fichier
- Dans l'écran « Import massif », partie « Produits », sélectionnez votre fichier : .xlsx, archive .zip de fichiers CSV, ou fichier .csv.
- Cliquez sur « Analyser le fichier ». L'analyse se fait en arrière-plan : vous pouvez quitter la page.
- À la moindre erreur, rien n'est importé. Chaque erreur est indiquée avec son onglet, sa ligne et sa colonne. Téléchargez le fichier annoté (Excel), où les cellules en erreur sont surlignées avec l'explication en commentaire, ou la liste des erreurs (CSV). Corrigez, puis renvoyez le fichier.
- Sans erreur, un récapitulatif indique les produits créés, modifiés et supprimés. Si des produits ont été modifiés sur le site depuis votre export, ils sont listés : vous pouvez les télécharger tels qu'ils sont sur le site, et l'import ne les écrase que si vous recopiez le code affiché.
- Choisissez « Importer maintenant » ou programmez l'import à une date et une heure, puis cliquez sur « Confirmer l'import ».
À retenir : une ligne retirée du fichier ne supprime rien, et une colonne retirée n'est pas modifiée. Seul « oui » dans la colonne Supprimer supprime un produit.
Ce tutoriel vous a-t-il aidé ?
