AltTextFix

Guide

Alt text examples, by the kind of image you actually have

The rule is one line: say what the image shows and why it is on the page, in under 125 characters, without "image of". Everything below is that rule applied to the ten kinds of image that make up most of the web.

1. Product photo

Weak: "Product image" · "51Kf9xL.jpg" · "Buy now"

Good: "Navy wool overcoat on a model, collar up, against a grey studio wall."

The product title is usually next to the image on the page, so the alt should add what the title cannot: colour, material, angle, what is worn with it, the setting.

2. Logo

Good: "Harvest & Co. logo." That's the whole job. If the logo sits inside a link to the homepage that is already labelled, an empty alt is also defensible. Don't stuff the tagline in.

3. Decorative image

Weak: "Decorative banner image" — this gets announced, which is worse than nothing.

Good: alt="", no text at all. Dividers, background textures, and spacer gifs are not content.

4. Icon with a label next to it

If the text "Free shipping" sits beside a truck icon, the icon is decorative: empty alt. If the icon is the only thing conveying meaning (a star row for reviews), name the meaning: "Rated 4.6 out of 5".

5. Chart or graph

Weak: "Bar chart" · "Q3 results"

Good: "Bar chart: recycled fibre share rises from 31% in Q1 to 68% in Q3."

The point of the chart is the finding, not the chart type. Add a long description or data table nearby if the numbers matter.

6. Screenshot (of your app, a dashboard, an email)

Good: "Shopify admin order list filtered to unfulfilled orders, with the bulk action menu open." Someone who cannot see it needs to know which screen and which state.

7. Text inside an image

If a sentence lives in a JPG — a sale banner, a quote card, a slide — transcribe the sentence. "Summer sale banner reading 30% off everything until 31 August."

8. Portrait or team photo

Good: "Priya Raman, head of operations, standing in the warehouse aisle." Relevance beats description: in a team page, the name and role matter more than the jacket.

9. Infographic

Alt text cannot hold an infographic. Summarise the conclusion in one line and put the detail in body text or a linked table: "Infographic: three of the four delays come from customs paperwork."

10. Before/after or comparison pair

Label each half: "Kitchen before renovation: dated oak cabinets and a blocked window" / "Same kitchen after: white cabinets and the window opened up". If the pairing is explained in the caption, keep each alt short.

The five mistakes that show up in every audit

  1. Filenames as alt text — IMG_2841.JPG, hero-2-final-final.png.
  2. Keyword stuffing — "buy cheap running shoes online best running shoes sale" pinned to every photo.
  3. One alt for hundreds of images — "Product photo" repeated across the catalogue. Screen reader users hear the same sentence over and over, which is worse than silence.
  4. Missing alt attribute entirely — the browser then reads the filename aloud.
  5. Describing decorative images — noise that buries the content.

See what all of this looks like on your site

Free audit of one page: every image, what it says now, what it should say, and which of these mistakes you're making.

Related: bulk-editing alt text on Shopify · why alt text matters