Why Alt Text Goes Missing
Missing alt text is rarely deliberate. The usual causes:
- CMS uploads with no required field. Most content editors let you publish an image without ever prompting for alt text, so it silently defaults to nothing.
- Copy-pasted markup. An
<img>tag copied from another part of the site (or from a component library example) carries whatever alt text - or lack of it - the original had. - Icon components treated as decoration by default.SVG icon libraries and icon fonts often ship with no accessible name unless you add one explicitly, and it's easy to assume the surrounding component handles it when it doesn't.
- Descriptive images mistakenly marked decorative, or vice versa. Getting the distinction backwards is nearly as common as forgetting it entirely.
How to Identify Every Missing Instance
This is one of the few checks Scanverra scores directly rather than just displaying. During a Browser Test scan, Scanverra runs Array.from(document.querySelectorAll("img")).filter((img) => !img.alt) against your rendered page and reports each match as a distinct "Missing alt attribute" issue, listing up to the first 10 per scan along with the image's source so you can find it fast. A separate real Lighthouse image-alt audit also contributes to your accessibility score - so a missing-alt problem shows up in two places, not one guess.
How to Fix It
1. Write a real description for meaningful images
Describe what the image conveys in context, not what it literally is - skip "image of" or "picture of," since screen readers already announce it as an image:
1<img
2 src="/keyboard-side-profile.webp"
3 alt="Mechanical keyboard with low-profile keys and RGB backlighting"
4 width={480}
5 height={320}
6/>2. Mark purely decorative images empty, not missing
1<img src="/divider-flourish.svg" alt="" role="presentation" />3. Give functional icons an accessible name for the action they perform
1<button aria-label="Search">
2 <SearchIcon aria-hidden="true" />
3</button>4. Don't keyword-stuff alt text
Alt text that reads like a string of SEO keywords instead of a real description fails both the accessibility purpose (it's not useful to a screen-reader user) and, in practice, does nothing for rankings either - write it for the person who can't see the image.
How Scanverra Detects Alt Text Issues
Scanverra's Browser Test genuinely inspects every rendered <img>element on the page and scores missing-alt findings as real accessibility issues, capped at the first 10 per scan - it's not a display-only field, it's counted against your score.
