Skip to article content
WCAG Guide

ADA Alt Text Requirements: The #1 Violation That Gets Sites Sued

15 min readBy WCAGsafe Team
Missing Alt Text — the #1 ADA violation that gets sites sued, shown with a browser window flagging an image that has no alt text next to a gavel and a lawsuit document

Missing alt text is the single most commonly claimed issue in website accessibility lawsuits.

It is also one of the fastest violations to fix — most cases need no developer at all. This guide shows you exactly what the law requires and how to write alt text that passes.

Scan your site free to find missing alt text

What Is Alt Text (and Why It's the #1 Cited Violation)

Alt text — short for "alternative text" — is a written description attached to an image in the HTMLaltattribute. Sighted visitors never see it, but people who are blind or have low vision rely on it completely. Their screen reader reads the alt text aloud so they know what the image shows or does. Alt text also appears when an image fails to load, and search engines use it to understand pictures.

Here is the problem that turns it into a lawsuit magnet: when an image has no alt attribute, most screen readers do not stay silent — they announce the file name instead. A blind shopper hears "I-M-G underscore 4-8-2-1 dot j-p-g" where a product description should be. On an image that is actually a link or button, they may hear nothing usable at all, leaving them unable to navigate or buy.

Under the ADA, U.S. courts and the Department of Justice reference the Web Content Accessibility Guidelines (WCAG) as the compliance standard. Alt text is governed by the very first success criterion, 1.1.1 Non-text Content (Level A) — the most basic tier. You literally cannot claim any level of WCAG conformance if meaningful images lack text alternatives. It is the floor, not the ceiling.

Why is it cited more than any other issue? Two reasons. It is everywhere — nearly every website has images, and a large share have at least some missing descriptions. And it is trivially easy to prove: an automated scanner just checks whether the altattribute exists. That combination — extremely common and machine-verifiable — is why missing alt text tops both accessibility audits and the demand letters that follow. It sits right alongside low color contrast as one of the two most-litigated violations on the web. For the wider list, see our guide to fixing common WCAG violations.

What WCAG Requires — By Image Type

The rule sounds simple — "give every image a text alternative" — but the right alt text depends on what the image is doing on the page. Here is the decision table. Every row maps to WCAG 1.1.1.

Image typeWhat the alt text should do
Informative (photos, charts, diagrams that carry meaning)Describe the information or content the image conveysalt="Bar chart: ADA website lawsuits rose from 2,314 in 2018 to 4,605 in 2023"
Functional (image is a link or button)Describe the action or destination, not the picturealt="Search" (on a magnifying-glass icon button)
Decorative (dividers, background textures, mood photos)Use an EMPTY alt so screen readers skip italt="" (never omit the attribute — that reads the filename)
Text in an image (a logo wordmark, a banner with words)The alt text must contain the same words shown in the imagealt="WCAGsafe" (for a logo) · alt="50% off ends Sunday" (for a promo banner)
Complex (infographics, detailed maps, data-rich figures)Short alt + a longer description nearby (caption or linked text)alt="Sales funnel infographic — full breakdown below" + visible description
CAPTCHA / image puzzlesAlt describes the purpose and offers an alternative (e.g. audio)alt="CAPTCHA: enter the letters shown, or use the audio version"
The golden rule: ask yourself "if this image disappeared, what information or function would a sighted visitor lose?" Write exactly that. If the answer is "nothing" — it is decorative — use an empty alt="".

How to Write Alt Text That Passes — 6 Rules with Examples

These six patterns cover the vast majority of real-world alt-text mistakes. Each has a failing-vs-passing example so you can see the fix in practice.

Product images: describe what a buyer needs to know

Why it matters

On e-commerce sites, the image often IS the product information — color, style, angle. A blind shopper who hears "IMG_20482.jpg" has no idea what they are about to buy. This is the single biggest source of alt-text lawsuits because stores have hundreds of product photos.

How to do it right

Describe the product the way a helpful salesperson would: type, key attributes, and variant. Skip "photo of" — screen readers already announce it as an image.

Example

✗ Fails

alt="IMG_4821.jpg"

✓ Passes

alt="Men's navy blue slim-fit cotton oxford shirt, front view"

✗ Fails

alt="product"

✓ Passes

alt="Stainless steel insulated water bottle, 24oz, matte black"

Describe purpose, not appearance

Why it matters

Alt text should convey why the image is there, not narrate every pixel. Over-describing ("a smiling woman in a red jacket standing near a window on a sunny day") is as unhelpful as saying nothing when the point of the image is simply "customer support team."

How to do it right

Ask: if I removed this image, what information or function would a sighted user lose? Write that. Keep it concise — aim for roughly 125 characters or fewer so screen readers do not truncate it.

Example

✗ Fails

alt="woman smiling wearing headset in bright modern office"

✓ Passes

alt="Contact our support team"

✗ Fails

alt="green upward arrow graphic icon vector"

✓ Passes

alt="Revenue increased 20% year over year"

Empty alt for decorative images — never a missing attribute

Why it matters

There is a critical difference between no alt attribute and an empty one. If you omit alt entirely, most screen readers fall back to reading the file name aloud — "hero-bg-final-v3-compressed.png." An empty alt="" tells the screen reader to skip the image silently.

How to do it right

For purely decorative images — spacers, borders, background flourishes that add no information — use alt="". For meaningful images, always write real alt text. Never leave the attribute off.

Example

✗ Fails

<img src="divider.png"> (no alt — reads the filename)

✓ Passes

<img src="divider.png" alt=""> (decorative, skipped)

Functional images: describe the action, not the icon

Why it matters

When an image is inside a link or button, the alt text becomes the accessible name of that control. A hamburger-menu icon with alt="three lines" tells the user nothing about what happens when they activate it.

How to do it right

Describe the destination or action. If the icon sits next to visible text that already labels it, the image can be decorative (alt="") to avoid a duplicate announcement.

Example

✗ Fails

alt="pdf-icon.svg" on a download link

✓ Passes

alt="Download the 2026 pricing guide (PDF)"

✗ Fails

alt="cart" on the checkout button

✓ Passes

alt="View cart (3 items)"

Images of text must repeat the text

Why it matters

Sale banners, quote graphics, and infographics that bake words into a JPG are invisible to screen readers unless the alt text reproduces those exact words. A "Spring Sale — 30% Off" banner with alt="banner" hides the entire offer from blind customers.

How to do it right

Put the same words that appear in the image into the alt text. Better still, use real HTML text over a background image so it is selectable, translatable, and zoomable.

Example

✗ Fails

alt="promo-banner.png"

✓ Passes

alt="Spring Sale — 30% off all orders, ends April 30"

Avoid redundant and keyword-stuffed alt text

Why it matters

Two opposite mistakes. Redundant: repeating "image of" or the same caption already visible below the photo, which makes screen readers say everything twice. Keyword-stuffing: cramming SEO terms into alt text, which is both bad for users and flagged by search engines.

How to do it right

If a visible caption already describes the image, use alt="" to prevent double-reading. Write for the human listening, not the search bot — natural, accurate descriptions rank fine.

Example

✗ Fails

alt="cheap ada compliance tool best accessibility scanner 2026"

✓ Passes

alt="WCAGsafe accessibility report showing a compliance score"

Good news for non-developers: alt text is almost always a content change, not a code change. Every major CMS — WordPress, Shopify, Squarespace, Wix, Webflow — has an alt-text field right in the image settings. You can fix most of these today without touching a developer. See the full non-technical workflow in our guide to fixing WCAG violations.

Real ADA Lawsuits Involving Missing Alt Text

Missing alt text is rarely the only claim in a website accessibility suit — but because it is the most common and easiest to prove, it appears in the majority of them. Here is the legal context that made image accessibility enforceable in the United States.

Robles v. Domino's Pizza (2019)

The landmark case confirming the ADA applies to websites and apps. The Ninth Circuit ruled against Domino's and the Supreme Court let the decision stand. Screen-reader incompatibility — including images a blind user could not interpret — was central to the complaint, cementing WCAG as the practical standard courts reference.

Sweetgreen (Colak v. Sweetgreen) (2024)

A plaintiff alleged that missing image descriptions blocked users with visual disabilities from the menu and ordering flow, under both the ADA and New York law. Notably, Sweetgreen had already settled a nearly identical accessibility suit years earlier — a reminder that unfixed alt-text issues invite repeat litigation.

Fox News & Beyoncé (Parker's) website suits (2018–2019)

High-profile class actions alleged the sites lacked alt text for images (alongside keyboard and navigation failures), leaving blind users unable to access content or complete purchases. Both illustrate that brand size offers no protection — image accessibility is judged the same for everyone.

Over 3,000 website accessibility lawsuits were filed under ADA Title III in 2025 alone, and the plaintiff's first step is almost always an automated scan — which surfaces missing alt text instantly. That makes it a frequent opening line in demand letters. For the full picture on who gets targeted and for how much, see our ADA lawsuit statistics, and if a letter has already arrived, read what to do when you receive an ADA demand letter.

Who's Most at Risk

Every image-heavy website is exposed, but a few sectors combine high lawsuit volume with the kind of content — large product catalogs, image menus, listing galleries — that makes missing alt text especially likely and especially damaging.

E-commerce & retail

The highest-risk category by far. Product catalogs contain hundreds or thousands of images, and each un-described product photo is a separate barrier — and a separate line in a demand letter. Missing alt text on "Add to Cart" imagery and product galleries is the most litigated pattern in retail.

Restaurants & hospitality

Menus posted as images, food photography, and reservation widgets are standard — and menu images with no alt text directly block a blind diner from ordering. Sweetgreen faced exactly this claim. Squarespace-built restaurant sites are especially prone to it.

Healthcare & medical practices

Provider headshots, facility photos, and image-based patient forms combine an older, vision-impaired audience with high legal exposure. Un-labeled images inside appointment and intake flows are the most consequential.

Real estate & listings

Listing galleries are pure image content — the photos are the product. Property photos with filenames instead of descriptions leave blind buyers unable to evaluate a home, a pattern that shows up repeatedly in accessibility complaints.

Hotels, gyms, dental offices, nonprofits, and financial services face the same exposure. We publish industry-specific ADA compliance guides that break down the common violations for each sector.

How to Check Your Website for Missing Alt Text

There are three levels of checking, from a quick manual pass to a full automated crawl.

  1. 1

    Listen with a screen reader

    Turn on NVDA (free, Windows) or VoiceOver (built into Mac and iPhone) and navigate your page image by image. You will hear immediately which images announce a file name, say nothing useful, or read correctly. This is the ground truth — exactly what a blind visitor experiences.

  2. 2

    Inspect elements or run Lighthouse

    Right-click an image and choose "Inspect" to see whether it has an alt attribute and what it says. Or run the free Lighthouse accessibility audit in Chrome DevTools, which flags images with no alt on the current page. Fast for one page, tedious across a whole site.

  3. 3

    Scan your entire site automatically

    A real website has dozens of pages and potentially thousands of images — far too many to check by hand, and new images get uploaded constantly. An automated scanner crawls every page, flags every image missing alt text at once, and can re-scan on a schedule so regressions are caught before a plaintiff finds them.

Find every image missing alt text — in 60 seconds

WCAGsafe crawls your whole site and lists every image missing a description, page by page, with plain-English fix guidance. No screen-reader marathon required.

Scan my website free

Alt Text Checking Tools Compared

Different tools solve different problems. A screen reader tells you the truth for one page; an automated crawler is the only practical way to audit an entire site. Here is how the main options compare.

Screen reader (NVDA / VoiceOver)

Best for: Hearing what users actually experience

Free. Turn one on and navigate your page by image — you will immediately hear which images announce a filename or nothing at all. The ground truth for alt text, but slow to do site-wide.

Browser DevTools / "Images" audit

Best for: Spot-checking one page

Inspect elements to see the alt attribute, or use Lighthouse's accessibility audit which flags images with no alt on the current page. Manual and one page at a time.

axe DevTools extension

Best for: Scanning a single page for image-alt failures

Runs axe-core on the open page and lists every image-alt and input-image-alt violation with its selector. You still repeat it page by page and interpret the output.

WCAGsafe

Best for: Finding every missing alt across your whole site

Crawls your entire site, flags every image missing alt text (plus 90+ other WCAG checks) sorted by impact, and re-scans on a schedule so new uploads do not silently reintroduce the problem. Same axe-core engine, without the page-by-page grind.

The honest summary: use a screen reader to learn what good alt text feels like, then use an automated site scan to make sure nothing is missing across every page — and keep scanning, because every new image upload is a chance to reintroduce the problem.

Frequently Asked Questions

Is alt text legally required for ADA compliance?

Yes. The ADA references WCAG, and WCAG 1.1.1 (Level A) requires a text alternative for every meaningful image. It is the most basic requirement — you cannot reach any WCAG conformance level without it.

What happens if an image has no alt text?

Most screen readers read the file name aloud (e.g. "IMG_4821.jpg"), which tells a blind user nothing. This blocks access to the image's content or function and is the most commonly cited issue in accessibility lawsuits.

How long should alt text be?

Roughly 125 characters or fewer. Some screen readers truncate longer text. For complex images like infographics, pair a short alt text with a longer description in a caption or linked page.

What about decorative images?

Use an empty alt attribute (alt="") so screen readers skip them. Critically, never omit the attribute entirely — that causes most screen readers to read the file name instead.

Can missing alt text actually get me sued?

Yes. It is the most frequently claimed barrier in ADA website suits. Domino's, Sweetgreen, and Fox News have all faced accessibility litigation citing inaccessible images. Automated scans surface it instantly, so it is often the opening evidence.

Does alt text help SEO?

Yes — search engines use it to understand images and it can improve image search visibility. But write for the human on a screen reader first; keyword-stuffing alt text hurts accessibility and is penalized by search engines.

Do I need a developer to fix alt text?

Usually not. Every major CMS (WordPress, Shopify, Squarespace, Wix, Webflow) has an alt-text field in the image settings. Most fixes are content edits you can make yourself today.

The Bottom Line

Missing alt text is the most common — and most easily proven — accessibility violation on the web, which is why it heads so many demand letters. It is also one of the cheapest to fix: a content edit in your CMS, no developer required for most images. Remember the core rule — describe the purpose, not the pixels; empty alt="" for decoration; never leave the attribute off — and you eliminate the single biggest source of ADA website complaints.

Start by finding out where you stand. Scan your site, fix the descriptions in your CMS, and set up monitoring so new uploads do not quietly reintroduce the gap. For the other top violation, read our ADA color contrast requirements guide, and for the full standard in plain English, see the ADA compliance checklist for small businesses.

Alt Text Quick Reference

  • Every meaningful image needs alt text (WCAG 1.1.1, Level A)
  • Describe the purpose or content — not "photo of…" or the file name
  • Keep it concise: aim for ~125 characters or fewer
  • Decorative images: use empty alt="" (never omit the attribute)
  • Functional images (links/buttons): describe the action or destination
  • Images of text: repeat the exact words shown in the image
  • Don't keyword-stuff — write for the person using a screen reader
  • Re-scan after adding new images or products — regressions are common

See every image missing alt text on your site — free

WCAGsafe runs a full WCAG 2.1 AA scan using axe-core — the same engine behind Chrome DevTools — and flags every image missing a description, page by page. Prefer it handled for you? Our accessibility remediation services fix the violations for you.

Need industry-specific guidance?

Missing alt text hits image-heavy sites hardest. Browse ADA compliance guides by industry →