Comprendre le problème
Des miniatures manquantes sur WordPress signifient que les versions redimensionnées des images n'existent pas ou ne sont pas trouvées. La cause est un échec de génération lors du téléversement, une migration sans les fichiers, ou un module de traitement d'image absent côté serveur.
La piste à vérifier
Régénérez les miniatures avec un plugin dédié ou WP-CLI, vérifiez que la bibliothèque GD ou Imagick est active, et contrôlez les permissions du dossier uploads.
Comment reconnaître ce bug
- Les miniatures sont absentes dans la bibliothèque de médias
- Les images s'affichent en taille réelle là où une miniature est attendue
- Les vignettes des articles ou produits n'apparaissent pas
- Le problème est apparu après une migration ou un changement de thème
Qu’est-ce que ce bug ?
À chaque téléversement, WordPress crée plusieurs versions d'une image (miniature, moyenne, grande) à partir des tailles définies dans les réglages. Si cette génération échoue ou si les fichiers redimensionnés sont absents, WordPress ne trouve pas les miniatures. L'image originale reste intacte, seules les déclinaisons manquent.
Pourquoi ce problème apparaît
Génération échouée au téléversement
Un manque de mémoire PHP a empêché la création des versions redimensionnées.
Migration incomplète
Le dossier uploads a été transféré sans les fichiers de miniatures, ou la base ne les référence pas.
Module de traitement d'image absent
Ni GD ni Imagick ne sont actifs côté serveur, WordPress ne peut pas redimensionner.
Permissions du dossier uploads
WordPress n'a pas le droit d'écrire les fichiers redimensionnés dans wp-content/uploads.
Comment réparer ce bug
Conservez une sauvegarde des fichiers et de la base de données. Testez les changements en préproduction lorsque c’est possible. Si vous ne maîtrisez pas une étape, demandez de l’aide avant de l’appliquer.
Régénérer les miniatures
Utilisez un plugin de régénération de miniatures ou la commande WP-CLI dédiée pour recréer toutes les tailles.
Vérifier le module d'image
Demandez à l'hébergeur de confirmer que la bibliothèque GD ou Imagick est installée et active.
Contrôler les permissions
Vérifiez que le dossier wp-content/uploads est en 755 et accessible en écriture par WordPress.
Vérifier les tailles d'image
Dans Réglages > Médias, contrôlez que les dimensions des miniatures sont correctement définies.
Comment éviter qu’il revienne
- Conservez une marge de mémoire PHP suffisante pour le traitement d'image
- Lors d'une migration, transférez l'intégralité du dossier uploads
- Régénérez les miniatures après un changement de thème modifiant les tailles d'image
- Vérifiez les permissions du dossier uploads après toute migration
Questions fréquentes
Régénérer les miniatures supprime-t-il mes images ?
Non. La régénération recrée uniquement les versions redimensionnées à partir des fichiers originaux. Les images d'origine ne sont jamais modifiées ni supprimées.
Pourquoi les miniatures manquent après un changement de thème ?
Chaque thème peut définir ses propres dimensions d'image. Un nouveau thème attend des tailles qui n'ont pas été générées pour les anciennes images : une régénération les crée.
Les miniatures manquantes affectent-elles le site ?
Surtout l'affichage et la performance : WordPress sert alors l'image en taille réelle, plus lourde, ce qui ralentit les pages. Le contenu reste cependant accessible.
Comment régénérer sans plugin ?
La commande WP-CLI de régénération de miniatures recrée toutes les tailles depuis la ligne de commande, sans installer d'extension supplémentaire.