Skip to content

How to check the alt text on your pages

Reviewed on 16 November 2026

You can see what alt text a page has in a few minutes, without touching any code. Run a free checking tool, then read the alt text yourself, one picture at a time.

A tool can tell you where alt text is missing. It can't tell you whether what's there is any good. For that you need your own ears and judgement.

Start with a checker tool

WAVE is a set of evaluation tools from WebAIM, an accessibility group at a US university. WebAIM says it "can identify many accessibility and Web Content Accessibility Guideline (WCAG) errors, but also facilitates human evaluation of web content".1

You can type a page address into the online tool. WebAIM also says there are browser extensions for Chrome, Firefox and Edge, which test pages directly in your browser.1 The extensions are handy for pages that aren't public yet. Follow WebAIM's own instructions for installing and reading the results, since the screens may change.

What to look for in the report: images with no alt, and images whose alt looks like a file name. Both are covered under common mistakes.

A simple routine for checking alt textPick your key pagesRun a checker tool on eachRead each alt text after the text before itFix and check again
Run it on your most visited pages first.

Read it the way a listener would

MDN, the web documentation run by Mozilla, describes a simple test. Read the alt text "together with preceding textual content", and ask whether it conveys the same meaning as the image.2

Do this for each picture. Read the sentence before it, then the alt text. If it sounds odd, rewrite it. If it says just "image", or a file name, rewrite it for sure.

Try a screen reader

WebAIM says screen readers are "very good for checking the accuracy and quality of image alternative text".3 You may already have one. WebAIM says VoiceOver comes with any Mac or iOS operating system, and that NVDA is free for use on Windows.3

There's a warning, though. WebAIM says that without knowing how to use a screen reader, testing "can be frustrating and counterproductive". It publishes guides on using NVDA and VoiceOver for evaluating pages.3 Start with those, and stick to a few pages.

Section508.gov, a US government site, adds a step. If an image is meant to be decorative, confirm during testing that it's skipped.4

See the page without its pictures

MDN lists situations where browsers don't show images. Visitors may choose not to display them to save bandwidth or for privacy.2 Most browsers let you turn images off. Check your browser's help pages for how.

MDN says that in these cases the browser "may replace the image with the text in the element's alt attribute".2 What you see varies by browser, so check your own browser's help. Scroll through the page. Does it still make sense? Where there's a gap, a picture is missing its words.

A simple routine

  • List your most visited pages. Your home page, contact page and main service pages are a sensible start.
  • Run a checker tool on each page and note what it flags.
  • Read each alt text after the text before it.
  • Fix the gaps and check the page again.

Keep a short note of what you changed and when, so you can see later what's done. And write new alt text as you add pictures, with the advice for everyday photos.

Which accessibility rules apply to a business depends on the country. Ask the relevant official body. Nothing here is legal advice.

Sources used

  1. WAVE Web Accessibility Evaluation Tools, WebAIM
  2. <img>: The Image Embed element, MDN Web Docs (Mozilla)
  3. WebAIM: Screen Reader User Survey and Testing, WebAIM
  4. Authoring Meaningful Alternative Text, Section508.gov (US General Services Administration)