Accessibility 5 min read

How to write good alt text for website images

Alt text helps people who can’t see your images. How to write it well, image by image.

On this page 10 sections

Alt text is a short written description of an image, stored in the image’s alt attribute. Most visitors never see it. For people who use screen readers, people on slow connections where images fail to load, and search engines trying to understand a page, it is the image.

Alt text is one of the simplest accessibility improvements a website can make, and one of the most often done badly: missing on important images, stuffed with keywords, or describing “image of image”. This guide explains how to write it well for each type of image.

The short answer

Good alt text:

  • describes what the image communicates in context, not every visual detail;
  • is short, usually one sentence or less;
  • doesn’t start with “image of” or “picture of”, because screen readers already announce an image;
  • is empty (alt="") for purely decorative images, so screen readers skip them;
  • describes the destination when the image is a link or button.

Why alt text matters

The Web Content Accessibility Guidelines require a text alternative for non-text content. Their very first success criterion, 1.1.1 Non-text Content, says images that convey information need a text alternative that serves the same purpose, and decorative images should be ignorable by assistive technology.

Alt text also helps search engines. Google’s image SEO guidance says it uses alt text, along with page content, to understand what an image shows. Writing for people first produces alt text that works for search too.

Ask what the image is for

The same photo can need different alt text on different pages. Before writing, ask: if this image disappeared, what would the reader miss?

  • On a team page, a portrait communicates who the person is: “Somchai Wong, project lead, smiling in the office.”
  • In an article about office design, the same photo might communicate the space: “Open-plan office with standing desks and plants by the windows.”
  • On a page where the photo is purely atmospheric and adds nothing to the text, it may be decorative.

The W3C’s alt decision tree walks through this question step by step.

Alt text for common image types

Image type What to write Example
Informative photo What the photo shows that matters to the page “Finished kitchen with white cabinets and an oak worktop”
Logo The organisation’s name; add “home” if it links to the home page “PORVIX home”
Icon next to text Usually empty, because the text already says it alt=""
Icon on its own as a button The action, not the picture “Search”, not “magnifying glass”
Linked image Where the link goes or what it does “Read the case study”
Chart or graph The key takeaway; give full data in text or a table nearby “Enquiries rose each month from January to June”
Screenshot The part that matters to the explanation “Search Console Pages report showing 42 indexed pages”
Decorative pattern or divider Empty alt=""

How to write it well

Be specific and concise

“Team photo” tells a screen reader user almost nothing. “Five members of the support team at the annual training day” tells them what the sighted reader sees. Aim for the shortest description that conveys the point. Most good alt text is under about 125 characters, simply because longer descriptions are harder to listen to.

Don’t repeat surrounding text

If the caption or the sentence next to the image already describes it, the alt text doesn’t need to say it again. Repetition makes screen reader users hear the same thing twice.

Include text that appears in the image

If an image contains words that matter, such as a sign, a banner or a quote graphic, include those words in the alt text. Better still, avoid putting important text in images at all, because it can’t be resized, translated or searched.

Avoid keyword stuffing

“Web design web designer best website design company” is not alt text. It is unhelpful to people and treated as spam by search engines. Describe the image naturally, and keywords will appear where they belong.

Write it in the page’s language

On a multilingual site, translate alt text along with the rest of the page. A Thai page with English alt text gives Thai screen reader users descriptions in the wrong language.

When to leave alt text empty

Use an empty alt attribute, alt="", for images that add nothing a reader would miss:

  • background textures, patterns and dividers;
  • icons placed next to text that says the same thing;
  • purely decorative illustrations.

Empty is different from missing. A missing alt attribute makes many screen readers read the file name instead, such as “IMG underscore 4021 dot jpeg”. Always include the attribute, even when it is empty.

Complex images

Charts, diagrams, maps and infographics carry more information than a short sentence can. Use the alt text for a brief summary, then provide the full information elsewhere: in the surrounding text, a data table, or a linked description. That helps everyone, not only screen reader users, because many sighted readers also prefer the numbers in text.

Checking alt text on your site

  1. Use an automated checker to find images with missing alt attributes. Tools such as Lighthouse flag these. Our guide to running an accessibility audit covers the wider process.
  2. Review alt text by hand. Automated tools can tell that alt text exists, not whether it is useful.
  3. Listen with a screen reader. VoiceOver on Mac and iPhone and NVDA on Windows are free. Hearing a page read aloud quickly reveals unhelpful descriptions.
  4. Make alt text part of publishing. If editors add images through a CMS, make the alt field visible and explain what to write.

Frequently asked questions

Does alt text help SEO?

Yes. Google uses alt text to understand images, which can help them appear in image search. The main benefit, though, is accessibility, and descriptive alt text written for people serves both purposes.

Should every image have alt text?

Every image should have an alt attribute. Informative images need a description; decorative images should have an empty one so assistive technology skips them.

Can AI write alt text for me?

AI tools can draft descriptions of what an image shows, but they don’t know why the image is on your page. Use them as a starting point, then edit the result so it describes what matters in context.

What to do next

Pick your five most important pages and check every image: is the alt text there, is it useful, and would you miss anything if you heard it instead of seeing the image?

Accessible images are part of every site we build through our website design and development service, and editor training covers how to write alt text when you add new images. For the wider picture, see our web accessibility guide and our guide to image optimisation.

Written by the PORVIX team

The people who design, build and maintain websites for growing businesses. We write about the questions that come up on real projects, in plain language, and update articles when the advice changes.

Published

How we work

Is your current site costing you enquiries?

A free, plain-language audit, by email within 2 business days.

Get a free audit
Get a free audit

Keep reading

More plain-language guides.

More on accessibility first, then other guides worth reading next.

All insights

Start here

Let’s build a website that brings in business.

Tell us about your project. You’ll hear back from a real person within one business day, with honest advice either way.

  • Free consultation
  • Fixed written quote
  • Your details stay private