Skip to content

Find what you need, instantly

Search components, ARIA roles & attributes, and WCAG criteria.

How to test

Images

Every image must expose the right text alternative for its purpose, or be hidden if it is purely decorative. The test is about meaning, not just the presence of an alt attribute.

What to test

  • Informative images have alt text conveying their meaning, not their file name.
  • Decorative images are hidden from assistive tech (empty alt="" or aria-hidden).
  • Functional images (icon buttons, logo links) describe the action or destination.
  • Complex images (charts, diagrams) have an extended description nearby or linked.
  • Text baked into images is avoided, or duplicated as real text.

How to test

  1. 1Turn images off (or use a text-only view) and confirm the page still makes sense.
  2. 2Navigate image-by-image in a screen reader (NVDA/JAWS “g”) and listen to each announcement.
  3. 3Inspect the accessible name in the browser's accessibility tree.
  4. 4For each image ask: does the alt convey what a sighted user gets, no more, no less?

Common failures

  • alt="image", alt="logo", or the raw filename.
  • Decorative images given descriptive alt that adds noise.
  • Icon-only buttons with no accessible name.
  • Charts with alt="chart" and no underlying data description.

WCAG 2.2 success criteria