Corrigez l'erreur “Invalid CSV header: missing headers” lors d'un import de produit dans Shopify

Shopify n'a pas trouvé une ou plusieurs colonnes obligatoires dans la première ligne de votre fichier. Renommez vos en-têtes de colonnes pour qu'ils correspondent exactement au modèle CSV produit de Shopify, dont Title et URL handle, puis importez à nouveau.

Message d'erreur dans Shopify

Invalid CSV header: missing headers

Signification de cette erreur

La première ligne d'un CSV produit est la ligne d'en-tête, et Shopify associe les colonnes par leur nom exact. Si une colonne obligatoire comme Title ou URL handle (Handle dans les anciens modèles) manque, ou si son nom est orthographié différemment, Shopify ne peut pas lire le fichier et arrête l'import.

Causes fréquentes

  • Le fichier venait d'une autre plateforme qui utilise ses propres noms de colonnes, comme Name au lieu de Title.
  • Une colonne obligatoire a été supprimée pendant la modification du fichier.
  • Un en-tête contient un espace superflu, une faute de frappe ou une formulation différente du modèle de Shopify.

Comment corriger

  1. Téléchargez le CSV produit d'exemple de Shopify, ou exportez un produit de votre boutique, pour voir les en-têtes corrects.
  2. Comparez la première ligne de votre fichier à l'exemple, colonne par colonne.
  3. Renommez toute colonne dont le nom ne correspond pas exactement, et ajoutez les colonnes obligatoires manquantes.
  4. Supprimez les espaces au début ou à la fin de chaque en-tête.
  5. Enregistrez le fichier en CSV UTF-8 et importez-le à nouveau.

Exemple

Avant
Handle,Name,Price
wool-scarf,Wool scarf,24.90
Après
URL handle,Title,Price
wool-scarf,Wool scarf,24.90

Name n'est pas une colonne Shopify. Le renommer en Title, et Handle en URL handle, correspond au modèle actuel.

Comment l'éviter

  • Partez du modèle de Shopify ou d'un export neuf pour créer de nouveaux fichiers, au lieu de composer les en-têtes à la main.
  • Utilisez un validateur qui compare chaque en-tête aux noms de colonnes actuels et anciens de Shopify.

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

Puis-je utiliser les anciens noms de colonnes comme Variant Price ?
Shopify accepte toujours les fichiers de son ancien modèle, mais gardez toutes les colonnes dans un seul format. Mélanger les anciens et les nouveaux noms dans un même fichier peut faire mal lire les colonnes.
Qu'est-ce que la fenêtre “Choose column headings” ?
Shopify l'affiche quand vos en-têtes ne correspondent pas. Vous pouvez y associer chaque colonne, mais corriger les en-têtes dans le fichier est plus fiable pour les imports suivants.

Vérifications associées dans Skuvera

Lire l'explication de Shopify

Autres erreurs d'import

Mis à jour le 30 octobre 2026