Images have alt text
Do the images in your content say what they show?
What we look for
We look at the images in the content of your home page and each sampled page, your newest posts among them — not the ones in the header, navigation, sidebar, or footer, so your logo doesn’t count — and count how many have an alt attribute.
One thing is charged: an <img> with no alt attribute at all. That image is missing its alt text. One exception: an image inside a <figure> whose <figcaption> has text isn’t charged, since the caption is its text. And an <img> with no src, srcset, or data-src isn’t a picture (it is a template a script fills in), so it isn’t counted at all.
An empty alt="" is believed, whatever the image’s size. It is you saying “decoration, skip it”, and only the author knows whether a picture is decoration. (A bare alt, with no value, is alt="".)
Some images aren’t counted at all: one under an aria-hidden="true" ancestor, or inside a link, a button, or a heading whose own text already says what it is (the image beside a link’s words, a poster inside a labelled button). Images marked as presentation only, tiny images embedded in the page itself, and spacers (a 1×1 GIF holding a layout open) are left out too. A lazy-loaded image counts as the picture it will be, even before its address is filled in. One image counts once on a page, however often the page repeats it; the same image on six pages is six.
The images from all the pages are pooled, and the score is the share with an alt attribute, never lower than 0.3 if any image has one. With fewer than three images, there’s too little to judge, and the criterion is skipped. The report names the pages with images missing it, and the first few of those images.
A note, never scored: when images 200 pixels wide or more (by their attributes, or by a size in their address) carry alt="", the report says how many are marked decorative. If any is a picture a reader needs, describe it. The note changes no mark.
Why it matters
Alt text is how an image explains itself to anything that can’t see it: a screen reader, and a bot. When an assistant reads a page with a product photo or a chart, the alt text is all it knows about that picture. Without it, the image is a gap.
Writing alt text also forces a useful question: does this image say something, or is it decoration? Both answers are fine, as long as the page says which.
How to pass
- For each image that carries meaning, write an alt that says what it shows, in a short sentence:
<img src="/team.jpg" alt="The four founders outside the studio in Portland"> - For decorative images — background textures, dividers, flourishes — use an empty alt, so readers skip them:
<img src="/swirl.svg" alt=""> - In most site builders and in WordPress, there’s an alt text field on each image; fill it in when you upload.
Last changed .