Custom Astro websites. Built on Cloudflare.

Explore Plyo

Writing alt text that works

What to write, what to leave empty, and why most alt text on business websites is either missing or useless.

A line drawing of an image with its description in a box underneath on a pale pink cover

Alt text is the sentence a screen reader says in place of an image. It is also what search engines read, and what shows when an image fails to load. Most business websites either leave it blank or fill it with the filename, and both are a missed opportunity.

Describe the function, not the picture

The question is not “what is in this image” but “what would the reader lose if it were gone”.

A photograph of a finished kitchen on a case study page is not “kitchen”. It is “The finished kitchen at Harbour Lofts, with the original brick wall exposed above the run of units”. That tells a blind reader what the sighted reader is looking at, and it tells a search engine what the page is about.

Leave it empty when the image says nothing

An empty alt attribute, alt="", is a decision, not an omission. It tells a screen reader to skip the image entirely, which is correct for:

  • Decorative background shapes and textures
  • A divider or flourish
  • An icon sitting next to a text label that already says the same thing

Omitting the attribute entirely is different and worse: some screen readers then read the filename out loud, which is how people end up listening to “IMG underscore 4471 dot J P G”.

Length

One sentence is usually right. Two if the image is carrying real information, like a chart or a plan. If you need a paragraph, the information belongs in the page text, with the alt text pointing at it.

Do not start with “Image of” or “Photo of”. The screen reader already announces that it is an image.

If an image is the only thing inside a link, the alt text has to describe where the link goes, not what the image shows. An image of a house that links to a listing should read “View the Barossa Place listing”, not “Terraced house”.

Charts, diagrams and screenshots

Give the takeaway, not the data points. “Requests served from the edge, rising through the working day and peaking at 2pm” is more useful than reading out twenty four values. Where the exact figures matter, put them in a table underneath; that helps everyone.

Google uses alt text to understand images, which matters for image search and for context on the page. It is a small signal and it is not a place to stuff keywords. Written honestly, it tends to contain the right words anyway, because you are describing the thing the page is about.

A quick audit

Open any page, turn off images in the browser, and read it. If sections become meaningless, your alt text is missing. If it becomes a wall of filenames, it is wrong. If it still reads as a sensible page, it is right.

Updated

FAQ

Common questions

Ask a question

Does every image need alt text?

Every image needs an alt attribute. Not every image needs words in it: decorative images should have an empty one.

What about images in a CMS?

Make the field required and show an example next to it. Alt text written by whoever uploads the image is usually better than alt text written later by someone who was not there.

Does alt text affect rankings?

Indirectly and modestly. It helps image search and adds context, but no amount of alt text will carry a thin page.

Should the logo have alt text?

Yes, the business name. If the logo links to the homepage, "Northbank, home" is clearer still.

Is alt text a legal requirement?

Accessibility regulations in the UK, EU, US and Australia all reference WCAG, which requires text alternatives for non-text content. For public sector bodies it is explicitly required, and for private businesses it is increasingly the standard courts refer to.

About Plyo Studio

Custom Astro websites. Built on Cloudflare.

Plyo Studio is an independent web studio that designs and builds fast, search-ready websites, web apps and interactive maps. Sites are custom-built in Astro and hosted on Cloudflare, so they load quickly and are easy for search engines and AI answer engines to read.

Founded by Chloe Nixon, a full stack developer and UI/UX designer from Australia, and Micky, a software engineer from New Zealand. Clients work directly with the founders from the first call to launch. Typical work: custom websites, migrations off Webflow, WordPress, Wix and Squarespace, web apps, and interactive maps and GIS. Projects are quoted at a fixed price before work starts.