Accents corrompus, produits dupliqués, images manquantes, import qui plante au bout de 2000 lignes : l'import CSV est l'étape où la plupart des migrations de catalogue dérapent. Voici les erreurs les plus fréquentes et comment importer proprement, même un catalogue de plusieurs milliers de références.
Excel enregistre par défaut en Windows-1252, pas en UTF-8. Résultat : tous les caractères accentués (é, è, ê, ç, ù) sont corrompus à l'import. PrestaShop attend un fichier UTF-8 sans BOM.
PrestaShop attend un point-virgule (;) par défaut, pas une virgule ni une tabulation. Une valeur contenant elle-même un point-virgule doit être encadrée de guillemets doubles.
Les colonnes de votre export d'origine ne correspondent presque jamais exactement aux champs attendus par PrestaShop. Partir du fichier d'exemple officiel évite l'essentiel des erreurs de correspondance.
Un fichier contenant une colonne ID qui correspond à des produits existants les écrase silencieusement. Supprimez cette colonne pour créer de nouveaux produits, ne la conservez que pour des mises à jour ciblées.
Une ligne avec plus ou moins de colonnes que les autres fait planter ou décale tout l'import qui suit. Cette vérification simple est trop souvent négligée avant le lancement.
Trois points de vigilance systématiques : les en-têtes doivent figurer en première ligne exactement comme attendu par PrestaShop, les prix doivent utiliser un point décimal (29.90 et non 29,90), et les catégories doivent être séparées par le caractère > pour respecter l'arborescence.
Avant tout import massif, testez systématiquement votre fichier sur un échantillon de 10 produits. Cela permet de repérer un problème de mapping ou d'encodage sans avoir à nettoyer des milliers de fiches erronées ensuite.
Au-delà de quelques centaines de références, l'import direct du fichier complet se heurte souvent à des limites serveur (timeout, mémoire). Quelques réglages évitent la plupart des blocages.
| Paramètre / action | Recommandation |
|---|---|
max_execution_time | 600 secondes |
memory_limit | 512 Mo |
post_max_size / upload_max_filesize | 64 Mo |
| Découpage du fichier | Lots de 500 à 1 000 lignes plutôt qu'un import unique |
| Indexation du moteur de recherche | Désactivée pendant l'import, réactivée ensuite — jusqu'à deux fois plus rapide |
Pour un catalogue dépassant le millier de produits, un hébergement mutualisé classique atteint vite ses limites. Un VPS ou un hébergement dédié à PrestaShop offre généralement une vitesse d'import 5 à 10 fois supérieure, un facteur qui compte particulièrement lors d'une migration sous délai serré.
Supprimer les doublons, harmoniser les unités et corriger les catégories dans le système d'origine plutôt que de reporter le nettoyage sur PrestaShop.
Repartir du fichier d'exemple officiel, encoder en UTF-8 sans BOM, vérifier le séparateur et le format des prix avant tout envoi.
Valider sur 10 produits, corriger les erreurs éventuelles, puis importer le reste du catalogue en lots de 500 à 1 000 lignes.
Contrôler un échantillon de fiches produit (prix, catégories, déclinaisons, images), réactiver l'indexation, puis relancer une réindexation complète du moteur de recherche.