The short answer. Ask: if this image disappeared, what would a visitor lose? Write that, in one short factual sentence, in the alt field. If the honest answer is “nothing — it is decoration,” set the alt text empty on purpose. Everything else on this page is working out that answer for product photos, charts, logos, buttons and photos of people.
An honest limit. Good alt text removes a real barrier; it does not certify a site. Automated scans can prove an alt attribute is missing, but they cannot judge whether the words are meaningful — that judgment is yours. This guide is practical information, not legal advice and not a certification of compliance with the ADA, WCAG or Section 508.
The one-sentence test
Cover the image with your hand. Read the page aloud. Where the picture was, say the one fact a visitor needs to keep following the page — the product, the result, the step, or the feeling the page is actually selling. That fact, written plainly, is your alt text. If you need a second sentence, the image is probably carrying information that belongs in the visible text as well.
Decide the image's job first
1. It adds nothing — make it silent
Background textures, dividers, stock photos that only set a mood next to text that already says everything: set alt to empty (alt="") or tick “decorative” in your builder. A screen reader will skip it instead of interrupting the page with “abstract blue shapes.”
Before: alt="happy team smiling office stock photo” under a heading that already introduces the team. After: alt="" — the heading does the work.
2. It shows something — name it
A product, a place, a finished job, a member of staff. Name the subject and the one detail that matters on this page: colour, material, angle, location or result.
Before: alt="IMG_2041.jpg”. After: alt="Blue ceramic mug, side view, showing the glazed handle”.
3. It is a link or button — say where it goes
When the image is the control, alt text is the button's name. A magnifying-glass icon that searches needs “Search”, not “magnifying glass”. A logo that links home needs “Acme Bakery — home”, not a description of the logo artwork.
Before: alt="cart icon”. After: alt="View basket, 2 items”.
4. It carries data — give the takeaway, then the data in text
Short alt text states the conclusion (“Sales rose in each quarter of 2025”). The numbers themselves belong in a table or paragraph next to the chart, where everyone — not only screen-reader users — can check them.
Before: alt="chart”. After: alt="Bar chart: bookings rose from 40 in January to 95 in June”, with the monthly table below.
5. It contains words — repeat the words, or better, remove them
Posters, banners and screenshots often hide the offer inside the picture. Alt text must include that exact text — but the stronger fix is real text on the page, which can be resized, translated and found by search.
Before: a sale banner image with alt="banner”. After: alt="Winter sale: 20% off all gift sets until Sunday” — and the same sentence as visible text.
6. It shows a person — describe the role, not guesses
Say what the person is doing and, if the page names them, use that name. Do not guess age, mood beyond what is plain, ethnicity or health from a photo. For a clinic or care business, never let alt text confirm that someone in a photo is a patient or client unless they have agreed to that publicly.
Before: alt="smiling elderly patient”. After: alt="Dr Lee reviewing a chart with a colleague” — only if that is who and what the photo actually shows.
Five mistakes that make alt text useless
- Keyword stuffing. “Best Portland bakery wedding cakes birthday cakes cupcakes” is spam read aloud. Write for a listener, not a search box.
- Repeating the caption. If the caption is visible, alt text that copies it word for word is heard twice. Add what the image shows, or set decorative.
- Starting every line with “image of”. The screen reader already says it is an image.
- Using the file name. IMG_2041, screenshot-final-v2 and logo are not descriptions.
- Leaving it to the uploader. The person who chose the photo for this page knows its job. A five-word note at upload beats a site-wide clean-up later.
A 10-minute pass for your homepage
- List every image on the homepage and your main money page.
- Mark each one: decorative, informative, functional, data, or text-in-image.
- Decorative → empty alt. Functional → the action or destination.
- Informative → one factual sentence using the one-sentence test.
- Data or text → takeaway in alt, full content as real text nearby.
- Read the page aloud with images covered. Fix anything that sounds like a file name, a keyword list, or nothing at all.
Want the machine-provable part counted first? Our free instant homepage check counts images without alt text on your homepage in seconds, with no email needed. The full checklist for the other barriers is the ADA website compliance checklist, and text colours can be tested in the free WCAG Contrast Checker.
Draft in hand? Run it through the free Alt Text Checker — 8 checks on the wording, in your browser, before you publish it.
Get every provable barrier found for you
The Full Report scans your site against WCAG 2.2 AA and returns a dated PDF: every barrier found, ranked by severity, each with a plain-English fix. $15 one-time. The Watch Plan ($18/month) re-checks monthly so new uploads do not quietly bring barriers back.
Reports are a first-line check and documentation of good-faith effort — not a certification of ADA or WCAG compliance. Full refund if your report fails to generate; 30-day refund policy.
Frequently asked questions
What is alt text in plain English?
Alt text is the written description attached to an image in the page code. A screen reader speaks it aloud, search engines read it, and it appears when an image fails to load. It is not a caption — a caption is visible to everyone under the photo; alt text is heard or read only when the image itself cannot be used.
How long should alt text be?
One short factual sentence is usually enough — often under 125 characters. Say what a visitor needs from the image, then stop. If an image needs a paragraph, it is probably a chart or diagram that needs a longer description in the visible text nearby, with short alt text pointing to it.
What alt text should a decorative image have?
An empty alt attribute — alt="" in code, or the 'decorative' toggle in most site builders. Empty is not the same as missing: empty tells a screen reader to skip the image on purpose; missing leaves it to guess, and it often reads the file name aloud instead.
Should alt text start with 'image of' or 'picture of'?
Usually no. A screen reader already announces that the element is an image, so 'image of a blue mug' is heard as 'image, image of a blue mug.' Start with the content itself: 'Blue ceramic mug with a chipped handle on a wooden table.' Use 'screenshot of' or 'logo of' only when the type itself matters.
Do product photos need different alt text on every page?
Yes, if the job of the photo changes. The same mug photo on a product page should name the product, colour and angle; in a gift guide it should say which gift set it shows. Write alt text for the page the image sits on, not for the file in your media library.
Can I just copy my caption or file name as alt text?
No. A file name like IMG_2041.jpg tells a visitor nothing, and a caption is already visible — repeating it word for word makes a screen-reader user hear the same sentence twice. Alt text should add what the image itself shows, in words written for listening.
Written by ADA Site Check, Portland, Oregon. Questions: contact@getadasitecheck.com. This guide is practical information, not legal advice, and not a certification of compliance with the ADA, WCAG or Section 508.