« Post-processing of the image failed » : échec du traitement d’une image WordPress

Fiche du décodeur d'erreurs, mise à jour le 12 octobre 2026

GênantMédiathèque et images
Le message affiché
Post-processing of the image failed likely because the server is busy or does not have enough resources. Uploading a smaller image may help. Suggested maximum size is 2500 pixels.
Autres formulations du même message 2
  • Post-processing of the image failed. If this is a photo or a large image, please scale it down to 2500 pixels and upload it again.
  • Media upload failed. If this is a photo or a large image, please scale it down and try again.

Après l’envoi, WordPress fabrique plusieurs copies de l’image : miniature, tailles moyenne et grande, et une version réduite si la photo est immense. C’est le post-traitement. Le fichier est arrivé, mais le serveur a manqué de mémoire ou de temps pendant ce travail. Ces textes viennent des versions 5.3 à 5.8 ; l’éditeur de blocs affiche « Media upload failed » dans le même cas.

Pourquoi cette erreur apparaît

  • La photo compte énormément de pixels (appareil photo, smartphone) : décompressée en mémoire, elle pèse bien plus que sur le disque.
  • La mémoire accordée à PHP pour le traitement des images est trop faible.
  • Le temps d’exécution maximal est atteint pendant la création des différentes tailles.
  • Le thème et les extensions déclarent de nombreuses tailles d’image, autant de copies à produire à chaque envoi.
  • L’hébergeur plafonne les ressources de la bibliothèque d’images du serveur.

Comment corriger le problème

Vérifier ce qui reste dans la médiathèque

Après plusieurs tentatives, WordPress efface normalement l’image incomplète, mais pas dans tous les cas. Ouvrez la médiathèque : si l’image apparaît sans vignette ou en double, supprimez la copie défectueuse avant de recommencer.

Réduire la photo à la source

Redimensionnez l’image à 2500 pixels au plus sur le plus grand côté et enregistrez-la en JPEG. Une photo de plusieurs dizaines de mégapixels peut sembler légère sur le disque et pourtant saturer la mémoire du serveur une fois ouverte.

Mettre WordPress à jour

Si le message commence par « Post-processing », le site tourne sur une version ancienne de WordPress. Faites une sauvegarde, puis mettez à jour WordPress, le thème et les extensions : une version maintenue reçoit les corrections de sécurité et de stabilité.

Donner plus de mémoire au traitement des images

Dans l’administration, WordPress s’appuie sur la limite WP_MAX_MEMORY_LIMIT pour les tâches lourdes comme le redimensionnement. Ajoutez cette ligne dans wp-config.php, au-dessus de la mention « C’est tout, ne touchez pas à ce qui suit ». Elle reste plafonnée par la limite fixée par l’hébergeur.

define( 'WP_MAX_MEMORY_LIMIT', '512M' );

Recréer les tailles manquantes

Si des images sont passées sans toutes leurs tailles, WP-CLI peut les régénérer sans renvoyer les fichiers. L’option -only-missing ne recrée que ce qui manque, ce qui ménage le serveur.

wp media regenerate --only-missing --yes

Limiter le nombre de tailles d’image

Cette commande liste toutes les tailles déclarées par WordPress, le thème et les extensions. Si la liste est longue, désactivez celles qui ne servent pas dans les réglages des extensions concernées : chaque envoi demandera moins de travail.

wp media image-size

Faites une sauvegarde complète avant de mettre WordPress à jour et gardez une copie de wp-config.php avant d’y ajouter une ligne.

Un autre message d'erreur ? Collez-le dans le décodeur : il le reconnaît et vous oriente vers la bonne fiche.

Ouvrir le décodeur