Glossary

What is Alt text?

Also called: Image alt attribute, Alternative text

Alt text is a few words in the page code that say what a picture shows. Screen readers read it aloud, and it shows if the picture cannot load.

Why it matters

People who cannot see the picture rely on it, and search engines use it to understand images. Missing alt text is mainly an accessibility gap.

How Onbiom checks it

Onbiom reads the img tags in the homepage as first loaded and counts how many have an alt attribute. An empty alt is accepted as marking a decorative picture, and so are role presentation, role none and aria-hidden true.

It fails if any image has none of these. No images means not applicable. Whether the text is accurate is not assessed.

In your report this appears as: Image alt text.

How to check it yourself

  1. Open your homepage source and search for <img.
  2. Check each has alt="..." with a few useful words, or alt="" for decoration.
curl -s https://example.com/ | grep -io "<img[^>]*>" | grep -iv "alt="

Not sure about your own site? Paste your address and see in a minute which of these checks your site passes. Free, no account needed.

Check your site

How to fix it

WordPress
Open the Media Library, click a picture and fill in Alternative Text. In the editor, use the image block settings.
Shopify
Edit alt text on each product image or in the theme editor image settings.
Wix
Click the image, open settings and fill in the alt text field.
Any website
Ask your web person or hosting company to make the change, and send them the wording from your report.

Related terms

Sources and further reading

Last reviewed: