Seitenreport Seitenreport
Media in WordPress

Fix Alt Text Missing in WordPress

Informative and decorative images are treated separately. In WordPress you check media library and concrete image instance.

Media library and concrete image instance

The alternative text in the media library and the actually stored image block may deviate from each other. Check the published item again after the change.

The alt text in the media library does not have to be the only value: a block or builder can store its own text and image size. Therefore, examine the image used in the article and the delivered img edition.

Where to check the setting in WordPress

Select the specific image instance in the article and compare its alt text with the data set in the media library. For own PHP output, wp_get_attachment_image can provide sizes and responsive sources; a hard-coded img tag does not automatically use this output.

Example of this specific finding

Illustrative control case: An image explains the connection of a device but does not have an alt attribute. A purely decorative background wave, on the other hand, does not contain any additional information.

<img src="anschluss.webp" alt="Netzkabel am linken Anschluss einstecken">
<img src="dekorative-welle.svg" alt="">

follow-up audit in WordPress

After correcting image URL, check alternative text and selected responsive variant. A global media change does not use as proof that all existing blocks have been updated.

Provide a concise suitable alternative for the informative image. Decorative img elements with empty old; take into account the link function for linked images.

Derogations and scope

An empty old is intended for decorative pictures and may not be corrected as missing content.

Related: WordPress with classic or block theme. SEO plugins and page builders are different; there is no universal menu path for all installations.

Classify the general error

Definition, system-independent causes and further correction examples: Treat informal and decorative images separately

Configuration and test signal documentation

WordPress: Image output with sizes and attributes

W3C: Task and Alternative of an Image

web.dev: Optimizing image output

Related Media Mistakes in WordPress