WordPress : changer la taille des miniatures et régénérer les images

Vous avez changé les tailles dans Réglages > Médias, mais les images du site n'ont pas bougé. C'est normal : WordPress ne fabrique les différentes tailles d'une image qu'au moment où on l'envoie dans la médiathèque. Les anciennes images gardent donc leurs anciennes miniatures tant qu'on ne les régénère pas, avec WP-CLI (wp media regenerate) ou avec une extension.

Où changer la taille des miniatures dans WordPress ?

Dans l'administration, ouvrez Réglages > Médias. WordPress y propose trois tailles : miniature (150 x 150 pixels, recadrée, par défaut), moyenne (300 x 300 au maximum) et grande (1 024 x 1 024 au maximum). Les valeurs servent de limites : l'image est réduite pour tenir dans la boîte, sans être déformée.

Deux autres tailles existent sans apparaître dans cet écran : une taille intermédiaire de 768 pixels de large (medium_large) et, depuis WordPress 5.3, un plafond de 2 560 pixels au-delà duquel une image envoyée est réduite automatiquement. Un thème ou une extension peut aussi en ajouter.

Les mêmes réglages se changent en ligne de commande, pratique sur plusieurs sites :

wp option update thumbnail_size_w 400
wp option update thumbnail_size_h 400
wp option update medium_size_w 800
wp option update medium_size_h 800

Pour lister toutes les tailles réellement déclarées (celles de WordPress, du thème et des extensions) :

wp media image-size

Pourquoi les anciennes images gardent-elles l'ancienne taille ?

À chaque envoi d'image, WordPress crée un fichier par taille déclarée (photo-150x150.jpg, photo-300x200.jpg...) et mémorise leurs noms dans la base. Modifier un réglage ne touche pas aux fichiers déjà créés : seules les images envoyées après le changement profitent des nouvelles tailles. Pour les autres, il faut demander à WordPress de les refabriquer.

Comment régénérer les miniatures avec WP-CLI ?

Faites d'abord une sauvegarde du dossier wp-content/uploads : la régénération supprime les anciens fichiers de miniatures avant de recréer les nouveaux. Puis, depuis le dossier du site :

# Toutes les images de la médiathèque
wp media regenerate --yes

# Seulement les tailles manquantes (ne touche pas à ce qui existe)
wp media regenerate --only-missing --yes

# Une seule taille, par exemple la miniature
wp media regenerate --image_size=thumbnail --yes

# Quelques images précises (identifiants de la médiathèque)
wp media regenerate 123 456 --yes

Sur une grosse médiathèque, l'opération prend du temps : lancez-la dans un screen ou en tâche de fond plutôt que dans une session qui peut se couper.

Comment faire sans ligne de commande ?

Sans accès SSH, une extension fait le même travail depuis l'administration. Regenerate Thumbnails et Image Regenerate & Resize traitent les images par lots, avec une barre de progression. Une fois la régénération terminée, vous pouvez désactiver l'extension : elle ne sert qu'à ce moment-là.

Pourquoi la taille ajoutée par mon thème n'apparaît-elle pas ?

Une taille personnalisée se déclare dans le thème avec add_image_size(). Elle ne s'applique, elle aussi, qu'aux images envoyées après son ajout :

// functions.php du thème
add_action('after_setup_theme', function () {
    // 640 x 360, recadrée au centre
    add_image_size('carte-article', 640, 360, true);
});

Après l'ajout, lancez wp media regenerate --image_size=carte-article --yes pour la produire sur les images existantes.

Un site WordPress lent ou une médiathèque difficile à gérer relève souvent de l'hébergement et de la maintenance : nous pouvons nous en charger, parlons-en.

Questions fréquentes