En bref. Le texte alternatif se renseigne dans le bloc Image pour une insertion précise ou dans la médiathèque pour définir la valeur par défaut à l’insertion.

Définition : Le texte alternatif est une description textuelle qui remplace une image, enregistrée dans l’attribut HTML alt. Dans WordPress, le bloc Image permet de régler le texte alternatif pour chaque insertion, tandis que la médiathèque (Media Library) fournit une valeur par défaut lors de l’insertion d’une image.

Points clés

Au 17 octobre 2026, la documentation du bloc Image de WordPress situe le champ Texte alternatif (Alternative text) dans l’onglet Contenu (Content) de la colonne latérale du bloc.
La documentation de la médiathèque indique que le champ Texte alternatif (Alt Text) figure dans la fenêtre Détails du fichier joint (Attachment Details) de l’image et que les modifications y sont enregistrées automatiquement.
La documentation sur la modification des médias de WordPress explique qu’une image insérée individuellement n’est plus liée aux données de la médiathèque.
Les recommandations de Google pour le référencement des images présentent le texte alternatif comme un élément utilisé pour comprendre les images, avec la vision par ordinateur et le contenu de la page.

Où se trouvent les champs de modification ?

La documentation de l’écran de la médiathèque de WordPress explique qu’un clic sur la miniature d’une image dans la vue en grille ouvre la fenêtre Détails du fichier joint. Le champ Texte alternatif contient l’équivalent textuel de l’image. Les modifications effectuées dans cette fenêtre sont enregistrées automatiquement.

Pour une image déjà insérée dans un article ou une page, la documentation du bloc Image situe le champ Texte alternatif dans l’onglet Contenu de la colonne latérale. Une modification dans les réglages de ce bloc s’applique à cette insertion précise.

Cette distinction compte lorsqu’une image est réutilisée. La documentation sur la modification des médias indique que les données de la médiathèque fournissent les valeurs par défaut au moment de l’insertion. Une fois l’image insérée individuellement, ses données peuvent être modifiées séparément. La vérification des pages existantes porte donc aussi sur leurs blocs Image, même après une modification de la fiche dans la médiathèque.

À quoi servent les champs Titre, Légende et Description ?

La documentation sur la modification des médias de WordPress définit le Titre (Title) comme le nom du média, la Légende (Caption) comme une brève explication et la Description (Description) comme une explication de ce média. Ces champs sont distincts du texte alternatif.

La documentation du bloc Image décrit une légende affichée sous l’image, avec une commande Ajouter une légende (Add caption) dans la barre d’outils. Elle présente aussi un champ distinct, Attribut de titre (Title attribute), dans Réglages (Settings), puis Avancé (Advanced). Ce champ fournit un texte supplémentaire pour l’image que de nombreux appareils et navigateurs n’affichent pas. Vérifier le libellé du champ évite de confondre une légende ou le nom du média avec le texte alternatif de l’image.

Que doit contenir le code HTML ?

L’article de WordPress sur le référencement présente alt et title comme des attributs du balisage des images et des liens. Pour l’équivalent textuel de l’image, la documentation de Google sur les images donne cet exemple :

<img src="puppy.jpg" alt="Dalmatian puppy playing fetch"/>

Ici, src désigne le fichier image et alt fournit son équivalent textuel. Google recommande des descriptions utiles, adaptées au contexte de la page, et déconseille de remplir l’attribut de mots-clés. Après l’enregistrement, une vérification pratique consiste à inspecter l’élément image sur la page publiée et à lire la valeur de son attribut alt.

Pour une image décorative, le tutoriel du W3C sur les images décoratives présente un texte alternatif vide :

<img src="topinfo_bg.png" alt="">

Le tutoriel définit les images décoratives comme des images qui n’ajoutent aucune information à la page et explique qu’un texte alternatif vide permet aux technologies d’assistance de les ignorer.

Termes associés

Questions fréquentes

La modification du texte alternatif dans la médiathèque met-elle à jour les images déjà insérées dans les articles ?

La documentation sur la modification des médias de WordPress indique que les images insérées individuellement ne sont plus liées aux données de la médiathèque. Vérifiez séparément les blocs Image de vos articles existants.

Puis-je donner à une même image des textes alternatifs différents selon les pages ?

Oui. La documentation du bloc Image indique qu’une modification du texte alternatif dans les réglages du bloc s’applique uniquement à la page ou à l’article concerné.

Dois-je décrire une image purement décorative ?

Les recommandations du W3C sur les images décoratives prévoient une valeur alt vide à cet effet. Dans les réglages du bloc Image de WordPress, vous pouvez marquer l’image comme décorative.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Où ajouter un texte alternatif aux images dans WordPress ?