Fail

Images without alt text

The short version

Add alt text; use alt="" for decorative images.

What it means

Some images have no text alternative: an <img> without an alt attribute, an image button or image map area without alt text, or an element with role="img" and no label. The examples show each element's position and start tag.

Why it matters

People who use screen readers hear the alt text instead of seeing the image. With no alt attribute at all, many screen readers read out the file name, such as "IMG underscore 2041 dot jpg", or skip the image without saying what it showed. Search engines also use alt text to understand images. WCAG 2 success criterion 1.1.1 asks for it.

How to fix it

  1. For an image that carries meaning, write what it shows or does: alt="Blue widget, front view".
  2. For an image that is only decoration, use an empty value: alt="".
  3. For a linked image or an image button, describe where it goes or what it does: alt="Basket".
  4. Keep it short; don't start with "image of".
  5. In a CMS, fill in the alternative text field in the media library.

Check it worked

Run the accessibility check again on the same address. The finding should be gone. Then try the page yourself with only the keyboard, and if you can, with a screen reader such as NVDA or VoiceOver: automated checks find only some problems.