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

How to write it

Imagine describing the picture to someone on the phone, in the context of the page. Then:

Examples by image type

ImageWeakBetter
Product photoshoeWomen's waterproof hiking boot in dark green, side view
Team phototeam.jpgOur five-person support team outside the Oslo office
ChartgraphBar chart: support response time fell from 9 to 2 hours in 2026
Linked logo or iconlogoHome (for a logo that links to the home page)
Button made of an imagearrowNext page
Decorative patternblue 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:

  1. Start where the visitors are. Your home page, top landing pages and top products.
  2. Find the gaps. Accessibility checkers in the browser (or the free tools from W3C and the browser makers) list images with missing alt text.
  3. 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.
  4. 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.

Keep reading

AI images for your website: replace photos without a designer

Where AI pictures fit on a website, how to prompt for them in place, and the checks to run before you publish one.

3 min read

How to write page titles and meta descriptions that get clicks

Lengths, structure and before-and-after examples for the two lines people read in search results, plus a quick way to fix them.

3 min read