Skip to content
Seitensicht
Tools & navigation

Write alt text

Good alternative text starts with understanding the image's purpose. That decision changes both the wording and the correct markup.

A picture card is connected to a described text field; an eye and a loudspeaker stand for accessible content.

How it works

Make image content accessible with words

  1. Determining image type
  2. Formulate the description yourself and check it
  3. Applying a suitable image markup

What is the image’s purpose?

This question is where most alternative text goes wrong, before you even start writing.

It shows something important

Describe what you see -- and that's what matters at this point, not every detail, but the statement.

Example: Workshop master repairs the gearshift of a road bike

Visible to everyone; alternative text is read by screen readers.

  • No text has yet been entered.
Markup · 2 rows · 48 B
<img src="image.jpg" alt="" width="" height="">

The dimensions in width and Height are intentionally blank. Enter the actual pixel dimensions to avoid layout shifts when the image loads.

What this tool does not do

It does not describe your image for you. That would require sending it to an image recognition service. Here, nothing leaves your computer. Generic descriptions such as “An image with a blue background” would not help anyway.

Instead, it guides you through the important decision and checks the text you have written.

The most common mistake

An Omitted attribute on a decorative image. Leaving it out makes screen readers announce the filename. A simple divider becomes “i-m-g-underscore-2-0-2-6-zero-three-dot-j-p-g”. The correct approach is an explicitly empty alt="".

Alt text or caption?

Everyone can see the caption; alternative text is used by screen readers and search engines. They can complement each other, but repeating the same sentence makes screen reader users hear it twice.

To find images without alternative text on your page, use the Website check — or, across the whole website, the Crawlers .