Elements with role="img" have no text alternative

Automated check role-img-alt, run with axe-core

WCAG

1.1.1 Non-text Content (Level A)

Severity

Serious: completable, but painful

Typical effort

Quick win, under 1 hour

Category

Content

Who this affects

Screen reader users.

Why it matters

Icon fonts and CSS background images marked as images are announced as "image" with no description.

How to fix it

Add aria-label or aria-labelledby to the element with role="img", or hide purely decorative ones with aria-hidden="true".

Related checks: Content

• Meters have no accessible name
• Progress bars have no accessible name
• Tooltips have no accessible name
• Table header cells are empty
• Images have no text alternative
• Image alt text duplicates nearby visible text
• Embedded objects have no text alternative
• Table scope attributes are used incorrectly

All checks