Axe rule guides
image-altcritical

Fix image-alt axe errors

An image is missing an alternative text decision, so screen reader users may lose information or hear a raw filename.

Affected users

Blind users, screen reader users, and users on text-only or low-bandwidth experiences.

WCAG mapping

1.1.1 Non-text Content (A)

Detection

wcagc flags images without an alt decision and links the finding to WCAG 1.1.1 for review.

Failing markup

<img src="/product.jpg">

Fixed code

<img src="/product.jpg" alt="Blue running shoe with white sole">

Sources and standards

FAQ

Can I use empty alt text?

Yes, but only for decorative images. Informative images need meaningful text that matches the image purpose in context.

Can automation judge whether alt text is meaningful?

No. Automation can find missing attributes, but a person must confirm whether the text is accurate and useful.

Scan the rest of the page

One rule rarely travels alone

Run a page through wcagc to find this rule, related WCAG issues, affected selectors, and manual checks that automation cannot judge.

Scan a page