Text alternatives · WCAG 2.0 Level A
<svg> elements with an img or image role must have alternative text
Ensure <svg> elements with an img, image, graphics-document or graphics-symbol role have accessible text.
What it means
The svg-img-alt rule flags elements that fail this check. It maps to WCAG success criterion 1.1.1.
Who it affects
People who are blind or have low vision and use screen readers, and anyone whose images fail to load.
How to fix it
SVGs with role="img" need a name, via a <title> child or aria-label.
<svg role="img" aria-label="Rated 4 out of 5">…</svg>Check it on your site
Run a free scan. If this rule fails, the results list the affected elements. Deque, which maintains axe-core, also documents this rule in detail: Deque University: svg-img-alt.
Quick answers
What does the axe rule "svg-img-alt" check?
Ensure <svg> elements with an img, image, graphics-document or graphics-symbol role have accessible text.
How do I fix "<svg> elements with an img or image role must have alternative text"?
SVGs with role="img" need a name, via a <title> child or aria-label.
Who is affected by svg-img-alt failures?
People who are blind or have low vision and use screen readers, and anyone whose images fail to load.
Automated accessibility scan. Results are informational and may not identify every accessibility issue. This service is not legal advice, a compliance certification, or a substitute for comprehensive manual accessibility testing.