La médiathèque WordPress permet d’associer des méta-données aux images. Bien remplir ces métas aide à retrouver l’image facilement en faisant une recherche. Mais y’a des subtilités.
Quand on est dans la page de détail d’une image WordPress, ont voit quatre champs : Alternative textuelle, Légende, Description et bien sûr le Titre de l’image (absent sur la capture d’écran).

Description de l’image
Interface d’édition d’une image dans WordPress. Trois champs visibles :
- Texte alternatif (renseigné “Seconde main.”)
- Légende (vide)
- Description” (vide, mais avec une barre de mise en forme)
Sous le champ “Texte alternatif”, une aide indique “Apprenez comme décrire à quoi sert une image (lien). Laissez vide si l’image est purement décorative)”. L’interface est en anglais, mais je traduis.
La subtilité, c’est qu’ils ne sont pas tous cherchables depuis la médiathèque. Si je cherche un mot qui est dans le titre ou dans la description de l’image, l’image va ressortir dans les résultats. Mais si je cherche un mot qui est dans le texte alternatif, eh ben non.
| Champ | Usage | Cherchable | Affiché en front |
|---|---|---|---|
| Texte alternatif | Explicite le contenu de l’image (accessibilité) | non | oui |
| Légende | Légende par défaut de l’image | oui | oui |
| Description | Mystère (voir plus bas) | oui | ça dépend |
| Titre | Nom de l’image | oui | oui (titre fichier) |
Ne pas mettre n’importe quoi en description
Le champ Description n’est généralement pas affiché et reste assez mystérieux. On peut être tenté d’y mettre n’importe quoi, vu qu’il ne s’affiche pas. Mauvaise idée, car ce champ peut devenir visible :
- en front, si le thème propose une page “fichier joint” pour les médias
- via l’API, si on fait une requête pour récupérer l’image
Le mystère du champ description
Selon la documentation de WordPress, ce champ donne “une explication de ce média en particulier”. Merci, la doc pas utile de WordPress. L’idée que le champ description s’affiche dans la page de fichier joint est mentionnée à plusieurs endroits sur le web (par exemple dans cet article sur les méta-données image dans WordPress).
Selon une formation accessibilité que j’ai fait 2022, ce champ servirait à proposer une description longue du contenu, quand le alt ne suffit pas. Le alt devrait rester assez court (80–120 caractère, soit environ 2 lignes d’une plage braille). Pour le reste, il faut utiliser Description.
Je reste sceptique là-dessus, parce que le contenu du champ description n’est pas repris automatiquement dans le code (j’ai testé), et que la description longue via ce champ ne peut pas être structurée, ce qui est précisément l’intérêt d’une description longue.
Vous avez aimé cet article ? N’hésitez pas à le partager pour faire chaud à mon petit cœur quand je lirai les stats d’audience microscopiques du site 🔬.
Laisser un commentaire