Alt text: how to write it, and how to fix it across your site
Alt text is the text a screen reader speaks in place of a picture, and what a browser shows when the picture doesn't load. It also tells search engines what an image shows. Most sites have some, a lot of it is unhelpful, and plenty is missing.
Why alt text matters
- Accessibility. People who use screen readers hear the alt text instead of seeing the picture. Without it, they hear a file name — or nothing at all. Accessibility guidelines such as WCAG require a text alternative for meaningful images, and in many countries public bodies and an increasing number of businesses are legally required to follow them.
- Search. Search engines read alt text to understand what an image shows, which helps both the page and the image itself appear in search.
- Resilience. When a picture fails to load, the browser shows the alt text in its place.
How to write it
Imagine describing the picture to someone on the phone, in the context of the page. Then:
- Say what matters here. The same photo needs different alt text on a recipe page (“the finished lasagne, sliced, with melted cheese on top”) and on a page about your kitchen (“our open kitchen with the pasta station in front”).
- Be specific and short. One sentence is usually enough; aim for roughly 125 characters or fewer.
- Skip “image of” or “picture of”. Screen readers already announce that it's an image.
- Include text that's in the picture, if it matters — a sign, a slogan, numbers on a chart.
- Don't stuff keywords. Use the words that describe the picture naturally; that's what helps search too.
Examples by image type
| Image | Weak | Better |
|---|---|---|
| Product photo | shoe | Women's waterproof hiking boot in dark green, side view |
| Team photo | team.jpg | Our five-person support team outside the Oslo office |
| Chart | graph | Bar chart: support response time fell from 9 to 2 hours in 2026 |
| Linked logo or icon | logo | Home (for a logo that links to the home page) |
| Button made of an image | arrow | Next page |
| Decorative pattern | blue swirl background | (empty: alt="") |
Two rules hide in that table. When an image is a link or a button, describe what it does, not what it looks like. And when an image is purely decorative, give it an empty alt attribute so screen readers skip it — don't leave the attribute out, or some will read the file name instead.
Complex images
For charts, maps and diagrams, keep the alt text to the main point and put the detail in the page text or a caption right next to the image, where everyone can read it.
Fixing alt text on a site that already exists
Most sites don't need a big project, just a steady pass through the pictures that matter most:
- Start where the visitors are. Your home page, top landing pages and top products.
- Find the gaps. Accessibility checkers in the browser (or the free tools from W3C and the browser makers) list images with missing alt text.
- Fix them in place. In Vibe Editor, click a picture on the live page and open the alt-text field in the same panel. Seeing the picture in its context is what makes the description good.
- Make it a habit. Every new picture gets alt text before it's published — including AI-generated ones.
On WordPress, alt text set this way is saved on the picture in the media library and on its tags in the page. On Payload it's saved on the upload, so it changes everywhere that upload is used — fix it once, and every page that shows the picture is fixed.
Can AI write alt text?
AI is good at describing what's in a picture, and it's a fine first draft for a large backlog. What it can't know is why the picture is on this page, or which details matter to your reader — so read every suggestion in context before you save it. Combine that with clear page titles and descriptions, and you've covered the text that search engines and assistive technology rely on most.
Try now