Writing alt text that helps, not just describes
By Emma Jansen, writer and content creator
Hi, I'm Emma. I write for the web, and some of the most useful sentences I write never appear on the page for everyone. They live in the alt text of an image. People who cannot see the picture, or whose image has failed to load, get that sentence instead. If it only says "photograph" or "chart", they have been told that something is there, and not what it was for. Alt text is not a caption for machines. It is a line of writing for a reader.
Say the point, not the object
"A bar chart with three bars" describes the object. "Fees are the same in all three options" gives the point. The second sentence is the one a sighted reader would take from the image after a moment of looking. That is the test I use: if I had to turn to someone in the room and tell them why this picture is here, what would I say? That spoken line, tightened, is usually the alt text. The format of the image can come later, or not at all, if it adds nothing.
Do not repeat the caption
When an image already has a visible caption, the alt text should not copy it word for word. That is two identical sentences for anyone who hears both. Let the caption carry the published line, and let the alt text fill in what the picture itself shows, or stay very short if the caption already does all the work. The two should work together, like a heading and a first sentence, not like a duplicated title.
Keep it as short as the job allows
A useful alt can be a few words, or a couple of sentences for a dense graphic. It should not be an essay. If you need a long explanation, the explanation may belong in the body text, where everyone can read it, with a shorter alt that points to the same fact. Decorative images (a rule, a texture, a repeated icon that adds no information) should have empty alt text, so a screen reader can skip them. A decorative image with a long description is not inclusive. It is noise.
Match the language of the page
Write the alt in the same language as the article, in the same register, and with the same names you use in the text. If a person is named in the piece, name them in the alt too, rather than a generic description, unless the point of the image is the situation and not the person. Be careful with guesses about age, mood or identity that the image does not require.
Special cases worth a habit
- Charts: give the trend or the comparison, and a key figure if one matters.
- Screenshots: say what the reader should notice, not the whole interface.
- Links on images: describe the destination or the action; in that moment the image is a button.
- Text in the image: those words belong in the alt, unless they already appear next to the image.
A last pass
I read only the alt text, in order, as if it were a small companion article. If it makes sense and does not parrot the captions, I leave it. If it sounds like a folder of file names, I rewrite. A reader who never sees the picture should still get the reason it was there.