How to check captions against WCAG 2.1 AA
“Are these captions WCAG compliant?” is not quite answerable as asked, and the gap between what people mean and what a file can establish is where most caption compliance claims go wrong. This page is about running the check honestly: per criterion, with the criteria that cannot be settled named rather than quietly dropped.
The criteria a caption file bears on
WCAG 2.1 Level AA contains a great deal that has nothing to do with captions. For a caption track it comes down to these, and to how much of each a file can settle:
| Criterion | What it requires | What a caption file can settle |
|---|---|---|
| 1.2.1Audio-only and Video-only (Prerecorded) | Prerecorded audio-only media has a transcript, and prerecorded video-only media has a transcript or an audio track that presents the same information. | Not evaluatedNothing in a caption file can settle this. It is reported as not evaluated and is never marked passed.Not evaluated. A caption file cannot show whether the media is audio-only or video-only, or whether a transcript or audio alternative exists for it. |
| 1.2.2Captions (Prerecorded) | Captions are provided for all prerecorded audio content in synchronized media. | Partly checkedThe file can show this failing, but cannot show it passing. No findings means nothing detectable is wrong — not that the criterion is met.A caption file proves captions exist, and can show they start late or skip stretches of the programme. It cannot prove they cover all audio, because that comparison needs the audio. |
| 1.2.3Audio Description or Media Alternative (Prerecorded) | Prerecorded video in synchronized media has audio description or a full text alternative. | Not evaluatedNothing in a caption file can settle this. It is reported as not evaluated and is never marked passed.Not evaluated. Audio description and text alternatives are separate from the caption file, and whether the video needs them depends on what it shows. |
| 1.2.4Captions (Live) | Captions are provided for all live audio content in synchronized media. | Not evaluatedNothing in a caption file can settle this. It is reported as not evaluated and is never marked passed.Live captioning is a property of the broadcast, not of a delivered file. Nothing in a sidecar can settle it. |
| 1.2.5Audio Description (Prerecorded) | Prerecorded video in synchronized media has audio description. | Not evaluatedNothing in a caption file can settle this. It is reported as not evaluated and is never marked passed.Not evaluated. Audio description is a separate track, and whether visual content needs describing depends on the video, which this engine never sees. |
Cited from W3C Web Content Accessibility Guidelines 2.1, Level AA (W3C Recommendation, 5 June 2018) — read the standard.
Running the check
The thing that makes a result citable is that the standard was named on the request, so the verdict comes back per criterion rather than as a score. In CaptionPass the library checks each file against the named standards and signs the result; for a scripted check, use the standard field on POST /api/v1/process for a scripted check in CI.
The anonymous free converter does not take a standard — it grades against a delivery preset, which answers the different question of whether a platform will accept the file. Both are useful; only one of them produces evidence.
The check is deterministic. The same file gives the same verdict, and every finding points at the cue that caused it, which is what lets somebody argue with the result instead of having to trust it.
What a clean result establishes
Less than it looks like, and saying so is the difference between evidence and marketing. For a criterion the file can only ever disprove, no findings means nothing detectable is wrong — not that the criterion is met.
WCAG conformance is also a property of the delivered experience: the player, the page, and the audio together. A caption file is one input. What a check establishes is what that input was tested against and what it found — which is precisely what a VPAT caption row needs, and precisely what an assurance does not provide.
Related reading
For authoring practice — reading speed, sound tags, contrast on burned-in captions — see WCAG-minded captions. That guide is about making captions good; this one is about establishing what they were checked against. If you are here because of a deadline, start with evidencing ADA Title II captions.
What this is not. A conformance receipt is evidence of what was checked, by which engine, against which version of which standard, and what it found. It is not a legal opinion, an audit, or a safe harbour. The engine that issues it reads the caption file and never the audio, so anything that needs the audio — above all whether the captions match what was said — is reported as not evaluated rather than assumed.
Common questions
- How do I check captions against WCAG 2.1 AA?
- Name the standard on the request. In CaptionPass the library checks each file against the named standards and signs a record of the result; for a scripted check, POST /api/v1/process takes a "standard" field. The anonymous converter on the home page does not take one — it grades against a delivery preset, which answers a different question. The check itself is deterministic: the same file gives the same verdict, per criterion, with each finding pointed at the cue that caused it, and the criteria it could not settle named rather than omitted.
- Which WCAG criteria apply to captions?
- 1.2.1 Audio-only and Video-only (Prerecorded) — Prerecorded audio-only media has a transcript, and prerecorded video-only media has a transcript or an audio track that presents the same information. 1.2.2 Captions (Prerecorded) — Captions are provided for all prerecorded audio content in synchronized media. 1.2.3 Audio Description or Media Alternative (Prerecorded) — Prerecorded video in synchronized media has audio description or a full text alternative. 1.2.4 Captions (Live) — Captions are provided for all live audio content in synchronized media. 1.2.5 Audio Description (Prerecorded) — Prerecorded video in synchronized media has audio description.
- Does passing the check mean the captions are WCAG conformant?
- Not on its own. WCAG conformance is a property of the delivered experience — the player, the page, and the audio together — and a caption file is one input to it. What the check establishes is what the file was tested against and what it found, per criterion, with the untestable ones named as untestable rather than quietly omitted.
- Why does WCAG 2.1 AA matter for US public bodies?
- The technical standard named by the ADA Title II web rule for state and local government content, due 26 April 2027 for large entities and 26 April 2028 for small ones. Takes effect 26 April 2027 — 6 months away.