Fix Guide
How to Fix Missing Image Alt Text
One or more meaningful image tags do not provide alt text for assistive technology or image-fallback contexts.
Recommended fix
Add useful alt text for informative images and alt="" for decorative images.
This guide is designed to pair with a scanner report. Run a URL scan first, then follow the implementation steps.
Developer task
Audit <img> tags and CMS media fields; add alt attributes that describe the image purpose in context.
Implementation steps
How to apply this fix
- List the images flagged as missing alt text in the report.
- For informative images, write concise alt text describing the purpose in context.
- For purely decorative images, set alt="" so assistive tech skips them.
- Update <img> tags and CMS media fields, then re-scan to confirm alt coverage.
Verify
Re-run the URL scan after deploying the change to confirm the issue clears and the Themerella Score updates.
Related guides