RevealTheme logo

Image Alt Text Auditor

Enter a public page URL and this tool fetches the HTML server-side, scans every <img> tag, and reports which images have a missing alt attribute, an empty alt, or a populated one.

How to use this tool

  1. 1

    Paste the full URL of a public, server-rendered page into the input field.

  2. 2

    Click Analyze to fetch the page on our server and parse its HTML.

  3. 3

    Review the Total, Missing alt, and Empty alt counts at the top.

  4. 4

    Scroll the per-image list (red = missing alt, yellow = empty alt) and copy the src values you need to fix.

How does this image alt text auditor work?

The tool sends the URL you enter to our server, fetches the raw HTML with a server-side request, and loads it into the Cheerio HTML parser. It selects every <img> element and reads each one's alt attribute, sorting the results into three states: missing (no alt attribute at all), empty (alt=""), and present (any non-empty value). Those counts are shown as tiles, and every image is listed by its src. Because it parses the HTML that the server returns, it only sees <img> tags present in the initial markup. It does not run JavaScript, so images injected client-side by React, lazy-loaders, or frameworks may not appear. It also does not inspect CSS background images, inline <svg>, <picture>/<source> sets, or ARIA attributes like aria-label and role='img'. Crucially, it reports presence only: it does not judge whether existing alt text is accurate, descriptive, or keyword-stuffed. Treat a clean report as 'every img has an alt attribute,' not as a full WCAG conformance pass. For decorative images the correct value is an empty alt (alt=""), which is why empty alts are flagged separately rather than as errors.

Common use cases

  • Auditing a marketing landing page before launch to confirm no hero or product <img> ships without an alt attribute.

  • Spot-checking a competitor's or client's live page to gauge how seriously they handle image accessibility.

  • Triaging an accessibility complaint by getting a fast list of images that screen readers would announce as unlabeled.

  • Reviewing a CMS template after a redesign to catch images where the author left the alt field blank.

  • Building an SEO punch list, since search engines use alt text to understand images and missing alts waste that signal.

  • Verifying that decorative images intentionally use alt="" rather than accidentally omitting the attribute entirely.

Frequently asked questions

Does this run in my browser or upload data anywhere?
Neither uploads your files. You give it a URL, and our server fetches that public page and parses its HTML. The page must be reachable from our server, so password-protected or localhost URLs will not work.
Why does my single-page app show zero images?
The tool reads the raw HTML the server returns and does not execute JavaScript. If your images are rendered client-side by React, Vue, or a lazy-loader, they are not in the initial markup and will not be detected. Test a server-rendered or pre-rendered version of the page.
What is the difference between 'missing' and 'empty' alt?
Missing (red) means the <img> has no alt attribute at all, which screen readers may read as the file name. Empty (yellow) means alt="", which is the correct, intentional way to hide a purely decorative image from assistive tech.
Does it check whether my alt text is actually good?
No. It only checks presence. It will not flag vague text like 'image1', overly long captions, or keyword stuffing. Aim for concise, descriptive alt text (often 5-15 words) and review meaningful images by hand.
Does it find background images, SVGs, or <picture> sources?
No. It only inspects <img> tags. CSS background-image, inline <svg>, <picture>/<source> elements, and ARIA-labeled graphics are out of scope, so a clean report does not guarantee every visual is labeled.
Is a clean result the same as WCAG compliance?
No. Alt-attribute presence is one requirement among many. WCAG 2.1 also covers contrast, focus order, captions, and more. Use this as a quick first pass, not a substitute for a full accessibility audit.

Related tools