How to write alt text that actually helps

Not "describe the image" — that's true but useless advice. Here's what to actually type into the box.

Alt text has two real audiences — a screen reader describing the page to someone who can't see it, and a search engine that can't see it either — and both need the same thing: a plain, accurate, reasonably short account of what the image is or does. Not keywords. Not "image of". What it actually is. (Auditing a whole page rather than one image? The on-page SEO checklist is the wider list.)

Content images versus decoration

Before writing anything, sort the image into one of two buckets. A content image carries information — a product photo, a chart, a screenshot — and always needs real alt text. A decorative image — a background texture, a divider, a mood-setting stock photo behind a heading that already says everything — should have empty alt text, or be marked decorative where your platform allows it, not described: a screen reader announcing "abstract blue gradient background" before every paragraph is adding noise. Getting this sort right matters more than perfecting any single description; the most common alt-text mistake is writing one for an image that needed none, or leaving one off an image that badly needed it.

What to actually type

Describe what a sighted visitor gets from looking at it — specific enough to be useful, short enough to stay readable. "Product photo" tells a screen-reader user nothing; "matte blue ceramic mug, 350ml, with a side handle" tells them what's actually for sale. A commonly used practical ceiling is around 125 characters. Beyond that, six habits separate useful alt text from filler:

Skip "image of" The screen reader already announces it's an image — those words are pure overhead, repeated on every single one.

An image that's also a link describes the action "Search" beats "magnifying glass icon" for a search button: what clicking it does is what a screen-reader user needs in order to decide whether to click.

A chart describes the finding, not the shape "Bar chart showing monthly sales rising from €2,000 in January to €9,500 in June" is useful; "a chart with six bars" is not.

Don't repeat the caption If visible text next to the image already says everything, let the alt text add something the caption doesn't or defer to it — otherwise a screen reader reads the same sentence twice in a row.

Drop the opinion words "Beautiful" and "stunning" describe your reaction, not the image — they only make sense to someone already looking at it.

Don't force the keyword in If the image genuinely is what the keyword describes, an honest description already contains it; if it isn't, forcing it in just makes the text less accurate.

Don't forget to translate it too

If a site runs in more than one language, alt text has to move with the translation. A description left in the source language is exactly as unhelpful to a screen-reader user as none at all — and it's easy to miss precisely because alt text is invisible on the rendered page: nobody scanning the translated version by eye notices the one field that never got touched. Whatever process translates your visible copy should cover image descriptions as a matter of course, not as an afterthought once someone reports it.

Where this shows up in Olmira

Alt text is a first-class field on every image in Olmira's media library, and the builder's SEO score checks every page for 100% coverage on content images as you write — it tells you how many still have none, and clicking the finding takes you to the section they sit in. See it in context on the website builder page.

Write it once, get it right

Free 30-day trial. Cancel any time; your content stays yours.