← All checks
Accessibilitymediumimage-missing-alt

Image has no recognised text alternative

ShipReady found one or more static HTML img elements without an alt attribute or another recognised accessible-name signal.

Why it matters

A text alternative can help people using screen readers understand meaningful image content while an empty alt can intentionally mark decoration.

How ShipReady detects it

What it inspects

ShipReady examines static, successfully fetched, untruncated HTML img elements.

What triggers a finding

The rule triggers when an img has no alt attribute and is not marked presentation or none, aria-hidden true, aria-label, or aria-labelledby.

What the evidence shows

The scanner observed the reported number of img elements without one of its recognised text-alternative signals. It reports a count and a shortened source sample.

Limits of this check

ShipReady does not render client-side changes, determine image meaning, inspect a computed accessibility tree, or perform a complete WCAG or assistive-technology audit. A missing alt attribute alone does not determine whether an image is decorative or meaningful.

How to fix it

Classify each image by purpose

Write concise alt text for meaningful images and use an empty alt only when the image is genuinely decorative in its context.

How to verify the change

Review the deployed markup and experience

Inspect affected image markup and test representative pages with the accessibility tools and assistive technologies appropriate to the product.

Expected: Meaningful images have an appropriate text alternative and decorative images are intentionally hidden from the reading order.

Related resources