Images with empty alt text
What it is
One or more images in the page’s content have no text alternative: the alt attribute is missing, or holds no text (alt="", or only spaces), and nothing marks them as decorative. An empty alt tells screen readers to skip the image, and with no alt at all they may read out the file name. That is fine for decoration, but it hides content when the image shows something visitors need, such as a chart, a product photo or a screenshot.
Why it matters
Visitors using a screen reader miss whatever the image conveys, and a link whose only content is such an image is left without a name. Meaningful images without a text alternative fail WCAG success criterion 1.1.1 Non-text Content (Level A), and since June 2025 the European Accessibility Act requires many businesses selling to consumers online in the EU to meet it. Google uses alt text to understand images, and an empty one gives it nothing.
How Asky checks it
Asky reads the page’s raw HTML and checks every <img> whose alt is missing, empty or only whitespace. Only images in the page’s own content count: those in the menu, header, footer or sidebar belong to the site template. Clearly decorative images are skipped: role="presentation" or role="none", aria-hidden="true" on the image or around it, width and height both numbers of 1 or less (tracking pixels), and images inside a link or button with text of its own. The rest are listed in one finding, which notes the images that lack the attribute. Decoration without one of these markers is reported too.
Reported as an opportunity with medium severity.
How to fix it
- Open the finding and look at each listed image where it appears on the page. An image without an
altattribute needs one either way: with text, or empty for decoration. - If the image carries information, such as a chart, a product photo, a screenshot or text set in an image, write alt text that gives the same information.
- If it is the only content of a link or button, write alt text that names the destination or action.
- If it is decorative, such as a flourish, a divider or an icon next to text that says the same thing,
alt=""is the correct markup: the W3C alt decision tree walks through the cases. Addingaria-hidden="true"to the image makes the choice explicit and stops Asky reporting it. - Check your CMS settings: an image marked decorative in Webflow, or left with an empty Alternative Text field in WordPress, is output with an empty alt, so make sure only true decoration is set up that way.
- To leave it as it is: if every listed image is decorative and you prefer not to change the markup, mark the issue resolved.
Example
A chart in the article on https://example.com/blog/pricing-guide has no alt attribute:
<!-- Before: no text alternative -->
<img src="/images/pricing-models.png">
<!-- After -->
<img src="/images/pricing-models.png" alt="Chart comparing flat, tiered and usage-based pricing for a 10-person team">