What this image alt text checker actually audits
Every image on a webpage falls into one of five buckets. Missing means the <img> tag has no alt attribute at all, the worst case for both screen readers and Google Image Search. Decorative-marked is the correct WCAG pattern: alt="" paired with role="presentation", signalling intent. Decorative-empty is alt="" without the role, which is ambiguous: maybe intentional, maybe a CMS dropping the attribute. Good alts are 5-125 characters, not the raw filename, and describe the image. Suspicious alts are filename-as-alt (IMG_2847.jpg), all-caps shouting, or single words like "image" or "photo".
The audit returns a coverage score (good + decorative-marked / total images), the count per bucket, and a CSV export of every alt value on the page. Pages above 95% coverage are accessibility-clean. Pages below 70% need work before WCAG 2.1 AA review.
How to use this alt attribute checker
- Enter Page URL. Paste any public URL. The tool fetches the rendered HTML and parses every
<img>tag, including those inside<picture>and<figure>elements. - Set Treat empty alt='' as intentional decorative. Choose Yes to honor the WCAG pattern (empty alt counts as a decorative declaration). Choose No to flag every empty alt as a gap, useful for CMS audits where you suspect the platform strips alt text.
- Hit Check alt text. The tool returns a thumbnail grid, a per-image classification, the coverage percentage, and a CSV download with image URL, alt text, and bucket label.
Try this with https://shopify.com. The audit might return 47 images: 38 good (81%), 6 decorative-marked, 2 missing, 1 suspicious (alt="logo.png"). Coverage is 94%. The two missing alts and the suspicious one are the action items. Fix them and re-run to confirm 100% coverage before shipping.
Why alt text quality matters for SEO and accessibility
Google uses alt text as the primary ranking signal for Google Image Search and as a content signal for the surrounding page. A 2024 Ahrefs study of 1.2 million image search results found that pages with descriptive alt text on every above-the-fold image ranked 30-50% higher in image search than pages with missing or filename alts. For accessibility, WCAG 2.1 Success Criterion 1.1.1 (Level A) requires text alternatives for all non-decorative images. Failing this criterion blocks WCAG conformance and creates ADA lawsuit exposure in the US.
Alt text also feeds AI assistants. ChatGPT, Claude, and Perplexity use alt text to understand image context when summarising pages. A product page with a hero image alted as "image1.jpg" tells the LLM nothing. Alted as "Black leather Chelsea boot, side profile, size 10" gives the LLM a usable description that ends up in summaries and citations. The website-metadata-checker covers the same ground for meta tags. This tool covers it for images.
Common mistakes
- Using the filename as alt text.
alt="IMG_2847.jpg"adds noise without meaning. Screen readers literally read "I M G underscore 2 8 4 7 dot J P G". Replace with what the image shows. - Alt-stuffing keywords.
alt="best running shoes nike air max running shoes 2026 buy running shoes"triggers spam filters and reads as gibberish to screen readers. Stick to one natural description. - Leaving decorative images as missing alt. A spacer GIF or background pattern needs
alt=""plusrole="presentation"so screen readers skip it. Missing alt forces the screen reader to announce the filename. - Writing 300-character alts. Screen readers cut off long alts and Google ignores anything past 125 characters. Keep alts under 125 chars and use the surrounding paragraph for detail.
- Repeating the caption in the alt. If a
<figcaption>already describes the image, the alt should add what the caption misses (the visual detail), not duplicate it.
Advanced tips
- Run the alt text audit after every CMS migration. WordPress to Webflow moves and Shopify theme swaps frequently strip alt attributes. Re-check coverage within 24 hours of a migration.
- Pair this with the h1-checker for a full on-page audit. Missing H1s and missing alts often correlate with the same templating bug.
- For e-commerce product pages, every product image alt should include the product name, color, and angle. "Red Adidas Samba, three-quarter view" beats "Red sneaker". Aim for 60-90 characters.
- For decorative icons inside buttons or links, use
aria-labelon the parent element instead of duplicating into the icon's alt. The icon then takesalt=""and the link text gets read once. - Track coverage over time. A monthly snapshot of every key landing page lets you catch regressions from CMS updates or new author uploads. Anything below 90% on a high-traffic page is a sprint ticket.
Once you know your alt text coverage, the next step is fixing the gaps and rechecking related on-page signals. Use the favicon-checker to confirm your favicon set renders across browsers, the website-metadata-checker to verify titles, descriptions, and Open Graph tags match your alt-text effort, and the h1-checker to confirm every page has a single descriptive H1 above the images you just audited. Together these four checks cover the on-page basics Google and screen readers depend on.