# Impossible d’ajouter ou d’afficher des images de produits sur PrestaShop

> Deux pannes différentes se cachent derrière « problème d’images » sur PrestaShop : l’upload qui échoue au moment d’ajouter une photo, ou l’image bien ajoutée mais mal affichée en boutique. Les causes ne sont pas les mêmes, et les distinguer évite de chercher au mauvais endroit.

- Source canonique : [https://allaux.fr/prestashop/problemes/images-produits-upload-affichage](https://allaux.fr/prestashop/problemes/images-produits-upload-affichage)
- Langue : FR
- Dernière mise à jour : 2026-08-03

## Réponse directe

> Si l’ajout échoue sans message, contrôlez upload_max_filesize et post_max_size côté PHP, puis les droits d’écriture sur img/p/. Si l’image est bien enregistrée mais s’affiche floue ou mal cadrée, lancez Régénérer les vignettes dans Design > Images : les formats attendus changent avec le thème et les anciennes photos gardent les dimensions du thème précédent.

## Quand l’upload échoue

Deux réglages PHP du serveur, upload_max_filesize et post_max_size, plafonnent la taille des fichiers acceptés à l’envoi. Des photos actuelles de plusieurs mégapixels dépassent facilement des valeurs par défaut fixées il y a des années. PrestaShop n’affiche pas toujours un message clair dans ce cas : l’ajout semble juste ne rien faire, ou échoue sans explication utile.

Des droits d’écriture insuffisants sur le dossier /img/p bloquent aussi l’ajout, avec le même symptôme : rien ne se passe, ou une erreur générique s’affiche sans indiquer la cause réelle.

## Quand l’image est ajoutée mais mal affichée

Au moment de l’ajout, PrestaShop génère automatiquement plusieurs formats redimensionnés de chaque image : vignette, image de fiche produit, zoom, etc. Un changement de thème modifie parfois les tailles attendues pour ces formats, ce qui explique que d’anciennes photos restent floues ou mal cadrées après un changement de thème alors que les nouvelles s’affichent correctement.

La solution native est le bouton Régénérer les vignettes, dans Préférences > Images : il recalcule tous les formats pour l’ensemble du catalogue selon les tailles actuellement définies. Un cache navigateur ou un CDN peut aussi continuer de servir une ancienne version de l’image après remplacement, ce qui donne l’impression que rien n’a changé alors que le fichier serveur est correct.

## Un message d’erreur vague ne veut pas dire un bug PrestaShop

> Un échec d’upload sans explication vient presque toujours d’une limite serveur, taille de fichier ou droits du dossier, plutôt que d’un défaut du logiciel lui-même.

## Ce que je vérifie dans l’ordre

1. **La taille réelle du fichier envoyé** — Comparée aux valeurs upload_max_filesize et post_max_size configurées côté serveur, pas seulement à une limite affichée dans PrestaShop.
2. **Les droits du dossier /img/p** — Le serveur doit pouvoir y écrire pour enregistrer l’image d’origine et générer les formats dérivés.
3. **La cohérence des tailles définies avec le thème actif** — Un thème récent attend parfois des dimensions différentes de celles utilisées par l’ancien thème, ce qui rend la régénération des vignettes nécessaire.
4. **Le cache navigateur et un éventuel CDN** — Avant de conclure à un bug, je vérifie qu’une ancienne version de l’image en cache n’explique pas simplement ce qui ressemble à un problème d’affichage.

## Pages liées

- **Boutique PrestaShop lente à charger** — Des images mal optimisées pèsent directement sur le temps de chargement des pages produit et catégorie. ([/prestashop/boutique-lente](/prestashop/boutique-lente))
- **Développement d’un module PrestaShop sur mesure** — Quand un traitement automatique des images à l’ajout, filigrane ou recadrage, dépasse le réglage standard. ([/prestashop/module-sur-mesure](/prestashop/module-sur-mesure))
- **Migration PrestaShop 1.6 vers 1.7 ou 8** — Pourquoi les formats d’image sont à revérifier après un changement de version ou de thème. ([/prestashop/migration](/prestashop/migration))

## FAQ

### J’ai augmenté la limite d’upload mais ça ne change rien, pourquoi ?

Deux réglages PHP interviennent, upload_max_filesize et post_max_size : si un seul des deux est augmenté, l’autre continue de limiter l’envoi. Il faut vérifier les deux, et parfois redémarrer le serveur pour que le changement soit pris en compte.

### Dois-je régénérer les vignettes après chaque ajout de produit ?

Non, uniquement après un changement de thème ou de format d’image. Un ajout normal génère déjà tous les formats nécessaires automatiquement.

### L’image s’affiche bien en admin mais pas en boutique, pourquoi ?

C’est souvent un cache navigateur ou un CDN qui continue de servir l’ancienne version. Un rafraîchissement forcé ou une purge de cache suffit généralement à vérifier cette hypothèse.

### Puis-je automatiser un traitement sur les images à l’ajout, filigrane ou recadrage ?

Pas nativement : ce type de traitement automatique demande un module développé sur mesure, accroché au moment de l’ajout de l’image.