Skip to content

Rule · Accessibility

Image has no text alternative

a11y/image-alterrorvoid a11yupdated

Why it matters

Screen readers announce the file name or nothing at all, so the content or purpose of the image is lost.

How to fix it

Add alt text that says what the image communicates; use alt="" for purely decorative images.

Example

tsx
<img src="/team.avif" alt="The team at the 2026 offsite">

References

void a11y reports 48 rules in this category. WCAG 2.2 AA through axe-core, plus checks axe can't do alone: visible keyboard focus, 24/44px target size on mobile, 320px reflow and disabled zoom.