Skip to main content
Complete Compliance Reference

What your website must do

Every requirement below is drawn from WCAG 2.1, ADA Title III, and applicable state laws. Click any badge to see the exact law — in plain English and legal language, with real lawsuit citations.

This page itself is compliant — here's proof

H1 heading (WCAG 2.4.6)·lang="en" on html (WCAG 3.1.1)·Skip nav link visible on focus (WCAG 2.4.1)

Interactive Demos

Try these live demonstrations of the most commonly failed requirements.

Color Contrast Demo

Sample body text — can you read this clearly?

Contrast ratio: 4.6:1

Passes AA4.6:1
Low4.6:1 — Passes AA (normal text)High
Large text (18pt+) — requires only 3:1

Alt Text Demo

This image's alt text is compliant because it describes both what the image shows and its purpose — not just “image” or the filename.

Keyboard Navigation Demo

When a user presses Tab, focus moves through each interactive element in order. Click play to simulate.

Currently focused: Skip to main content

Visual

Color contrast, alt text, captions, and everything your eyes use to read the web.

Color Contrast (Text)

Text on your website must be easy to read against its background. Small text needs a contrast ratio of at least 4.5:1, and large text (18pt or 14pt bold) needs at least 3:1. This helps people with low vision or color blindness read your content.

2 notable lawsuits

Robles v. Domino's Pizza LLC (2016)

Level AA·Visual

Non-Text Contrast (UI Components)

Buttons, icons, form input borders, and other interactive elements must have at least a 3:1 contrast ratio against their background. People with low vision need to be able to see and identify controls — not just read text.

1 notable lawsuit

NFB v. Target Corporation (2006)

Level AA·Visual

Images — Alt Text

Every meaningful image must have a written description (alt text) so screen reader software used by blind users can describe it. Purely decorative images should be marked to skip. Without alt text, blind users get zero information from your images.

2 notable lawsuits

NFB v. Target Corporation (2006)

Level A·Visual

Video Captions (Prerecorded)

Any pre-recorded video with spoken audio must have synchronized captions. This is required for deaf and hard-of-hearing users. Auto-generated captions (YouTube's default) do not meet this standard — they must be accurate and reviewed.

2 notable lawsuits

NAD v. Netflix (2012)

Level A·Visual

Audio Descriptions for Video

Pre-recorded videos must have audio descriptions — narration describing what's happening visually — so blind users can follow visual-only content like charts, demonstrations, or on-screen text. Think of it as a narrator for what the camera shows.

Level AA·Visual

Use of Color Alone

Never use color as the only way to convey information. For example, don't mark required form fields with just a red border — add a label like 'Required'. Colorblind users can't distinguish red from green. Always add a second signal (text, icon, pattern).

Level A·Visual

Navigation

Keyboard access, skip links, focus indicators — how users move through your site.

Keyboard Navigation

Every function on your website must work using only a keyboard — Tab, Enter, arrow keys, spacebar — without requiring a mouse. This is essential for people with motor disabilities and blind users who rely on screen readers. If it can't be clicked, it can't be done.

2 notable lawsuits

Conner v. Beyoncé's website (2019)

Level A·Navigation

Skip Navigation Links

Websites must provide a 'Skip to main content' link at the very top of the page. This lets keyboard users bypass the navigation menu — without it, a user pressing Tab must go through every nav link on every page before reaching the actual content. This page has one — press Tab to see it.

1 notable lawsuit

NFB v. Target Corporation (2006)

Level A·Navigation

Focus Visible (Keyboard Indicator)

When users navigate with a keyboard, they must always be able to see which element has focus — usually shown as an outline or highlight around a button or link. Many designers remove this outline for aesthetics, which makes keyboard navigation nearly impossible for people who can't use a mouse.

Level AA·Navigation

Descriptive Link Text

Link text must describe where the link goes. Generic text like 'Click here' or 'Read more' is inaccessible — screen reader users navigate a list of all links on a page, and 'Click here' gives zero context. Links should read like 'Download the 2024 Compliance Report (PDF)'.

1 notable lawsuit

Hanyzkiewicz v. Hasbro Inc. (2023)

Level A·Navigation

Forms

Labels, error messages, required fields — how users interact with your inputs.

Form Field Labels

Every input field in a form must have a visible label that is programmatically connected to the field. Placeholder text that disappears when you type does NOT count as a label. Screen readers must be able to announce what each field asks for — otherwise blind users fill out forms blind.

1 notable lawsuit

Robles v. Domino's Pizza LLC (2016)

Level A·Forms

Error Identification

When a user submits a form and makes an error, the error must be identified in text — not just with a red border — and must describe what the problem is. Screen readers need to announce the error. 'Please fix the errors' is not enough; 'Email address is invalid' is.

Level A·Forms

Structure

Headings, page titles, landmarks — the skeleton screen readers navigate.

Heading Structure

Pages must use headings (H1, H2, H3, etc.) in a logical hierarchy to organize content — not just for visual styling. Screen reader users navigate pages by jumping between headings, like a table of contents. Using H3 for font size while skipping H2 breaks this entirely.

Level AA·Structure

Page Titles

Every page must have a unique, descriptive title (the text shown in the browser tab). 'Home | JustCompliant' tells users exactly where they are. Identical titles like 'Welcome' on every page make navigation very difficult for screen reader users.

Level A·Structure

Interactive

Dropdowns, modals, carousels, tooltips — dynamic components with special rules.

Dropdown Menus

Dropdown navigation menus must work entirely by keyboard. Users must open, navigate, and close dropdowns using Tab, arrow keys, and Enter/Space. Hover-only dropdowns that can't be activated by keyboard are among the most common accessibility violations.

1 notable lawsuit

Conner v. Beyoncé's website (2019)

Level A·Interactive

Carousels and Slideshows

Image sliders and carousels are among the most commonly inaccessible components. They must: (1) be keyboard navigable, (2) have a pause button if they auto-play, (3) have descriptive labels per slide, and (4) announce slide changes to screen readers. Most third-party carousel plugins fail all four.

Level A·Interactive

Tooltips and Hover Content

Content that appears on hover must also appear on keyboard focus, stay visible long enough to be read, be dismissible with Escape, and allow the user to hover over the tooltip itself. This page's compliance badges are built to meet all four requirements.

Level AA·Interactive

Documents

PDFs and downloadable files linked from your site.

PDF Accessibility

PDFs linked from your website — menus, brochures, forms, contracts — must be accessible. This means tagged PDF structure, selectable text (not a scanned image), alt text for images inside the PDF, and fillable forms that work with screen readers. A scan of a paper document is completely inaccessible.

1 notable lawsuit

California Unruh Act cases (2022–2024)

Level AA·Documents

Mobile

Touch targets and zoom — requirements specific to phones and tablets.

Touch Target Size

Buttons, links, and interactive controls on mobile must be at least 44×44 CSS pixels — roughly the size of a fingertip. Tiny buttons placed too close together cause errors for people with motor disabilities or tremors. This is one of the most commonly failed mobile requirements.

Level AAA·Mobile

Pinch-to-Zoom

Your website must never disable mobile zoom. Many websites use a meta tag that blocks pinch-to-zoom — this makes the site unusable for people with low vision who need to enlarge content. Removing the restriction is a one-line fix, and it's one of the most common violations.

Level AA·Mobile

State Laws

Federal ADA is the baseline. These state laws add teeth — especially California.

California — Unruh Civil Rights Act

Cal. Civ. Code § 51(f)

Any ADA violation automatically triggers Unruh liability. Minimum $4,000 per violation, plus attorney's fees. A single non-compliant visit is a billable claim. California generates more digital accessibility lawsuits than any other state.

View legal text

Cal. Civ. Code § 51(f): 'A violation of the right of any individual under the federal Americans with Disabilities Act of 1990 shall also constitute a violation of this section.' Cal. Civ. Code § 52(a): damages 'not less than four thousand dollars ($4,000)' per violation.

$4,000 minimum per violation

New York City — Human Rights Law

NYC Admin. Code § 8-107

The most expansive anti-discrimination law in the US. Applies to any business with NYC customers — even if you're physically located outside the city. Civil penalties up to $125,000. Does not require a nexus to a physical location.

View legal text

NYC Admin. Code § 8-107(4)(a) prohibits disability discrimination by any 'place or provider of public accommodation.' § 8-502(a) allows private right of action with compensatory, punitive damages, and civil penalties up to $125,000 for unlawful discriminatory practices.

Up to $125,000 per complaint

Florida — ADA Title III (11th Circuit)

Gil v. Winn-Dixie (11th Cir. 2021)

Florida follows the 11th Circuit's 'nexus' requirement: your website must have a connection to a physical place of business. Pure online businesses have more protection here. But brick-and-mortar businesses with websites are still exposed under federal ADA.

View legal text

The 11th Circuit in Gil v. Winn-Dixie Stores (2021) held that a website must have a 'nexus' to a physical place of public accommodation to trigger ADA Title III. Florida Civil Rights Act (Fla. Stat. § 760.01) does not explicitly address web accessibility.

Injunctive relief + attorney's fees

Federal — ADA Title III

42 U.S.C. § 12182(a)

The Americans with Disabilities Act requires any business open to the public to provide equal access to people with disabilities. Courts consistently apply WCAG 2.1 AA as the technical standard. No statutory damages for private suits, but attorney's fees alone average $50,000–$200,000+.

View legal text

42 U.S.C. § 12182(a): 'No individual shall be discriminated against on the basis of disability in the full and equal enjoyment of the goods, services, facilities, privileges, advantages, or accommodations of any place of public accommodation.' DOJ Title II Final Rule (2024) codified WCAG 2.1 AA for government entities; private business rule forthcoming.

Injunctive + attorney's fees ($50K–$200K+)