Skip to main content
All rules

A11Y-018

SVG images have no accessible name

MediumDefault severity · Accessibility · Accessibility (WCAG 2.2 AA)

Last reviewed

What it checks

<svg role="img"> without aria-label, aria-labelledby or a <title> child.

Why it matters

role="img" tells assistive technology the graphic is meaningful, but there is nothing to announce.

Recommended fix

Add aria-label (or a <title>) describing the graphic, or remove role="img" and add aria-hidden="true" if it is decorative.

How to verify

Run axe and confirm no svg-img-alt issues.

Example fix prompt

Generic prompt (your report adds the evidence)
Please fix this production issue in my app.

Issue A11Y-018: SVG images have no accessible name
Site: https://your-app.example

First confirm the issue in the code or live config. If it is not present, say so and change nothing.
Task: For each <svg role="img"> in the evidence, add an aria-label describing it, or make it decorative with aria-hidden="true" and no role.

Constraints: make the smallest change that fixes this, keep the current design and behaviour, never paste secret values into code or chat, and tell me which files you changed.
Done when: Run axe and confirm no svg-img-alt issues.

References