Verify audio description or media alternative
Description
This rule does not automatically validate anything. It simply reminds you to manually verify that pre-recorded video content has either an audio description (also called described video) or a full text alternative (transcript) that conveys all important visual information. Audio description is a narration added to the soundtrack to describe key visual elements such as actions, scene changes, on-screen text, and facial expressions that are not already conveyed through dialogue.
This requirement aligns with WCAG Success Criterion 1.2.3 (Level A), part of the W3C Web Accessibility Initiative. The goal is that users who cannot see the video can still access all the information through an alternative format.
Disabilities impacted
- Blindness – People who are blind cannot see any visual content in a video. Without an audio description or transcript, they miss information conveyed through actions, expressions, scene changes, and on-screen text.
- Low vision – Users with low vision may not see fine visual details or fast-moving on-screen elements. Audio description fills these gaps by verbally describing what is happening visually.
- Cognitive disabilities – Individuals with cognitive or learning disabilities often benefit from text transcripts that allow them to read at their own pace, re-read sections, and better comprehend the content.
Why it matters
Video is increasingly central to web content, from educational materials and product demonstrations to entertainment and news. Without an audio description or media alternative, people with visual impairments are excluded from the information presented visually. This creates a barrier to equal access and may violate accessibility laws such as the Americans with Disabilities Act (ADA) and Section 508 of the Rehabilitation Act. Providing audio description or a full text transcript ensures that video content is inclusive and usable by a wider audience, improving the overall user experience for everyone.
Coding problems and solutions
Common coding problems
- No audio description available – The video player lacks any audio description track, and no separate described version is provided anywhere on the page.
- Missing or incomplete text transcript – The page does not include a transcript, or the transcript only covers dialogue while omitting visual actions, scene changes, and on-screen text.
- Audio description poorly synchronized – The audio description narration does not fit within natural pauses in the original soundtrack, causing overlaps with dialogue or cutting off prematurely.
- Transcript not linked or discoverable – A transcript exists but is not clearly associated with the video, placed far from the video player, hidden behind an obscure link, or only available after unnecessary user interaction.
- Audio description does not cover all visual information – The narration skips important details such as slide content, data visualizations, character expressions, or sign language interpretation.
How to fix it
Add a descriptive audio track using <track>
Use the HTML <track> element with kind="descriptions" to provide a WebVTT file containing audio description cues. The browser can play these cues during natural pauses in the dialogue.
<video controls width="640">
<source src="lecture.mp4" type="video/mp4">
<track kind="descriptions"
src="lecture-descriptions.vtt"
srclang="en"
label="English Audio Description">
<p>A text transcript is available below.</p>
</video>
<video controls width="640">
<source src="lecture.mp4" type="video/mp4">
</video>
<!-- No audio description or transcript provided -->
Provide a full text transcript
Include a complete transcript that captures dialogue, speaker identification, sound effects, and all relevant visual information. Place the transcript adjacent to the video or link to it prominently so it is easily discoverable.
<video controls width="640">
<source src="demo.mp4" type="video/mp4">
</video>
<details>
<summary>View full transcript</summary>
<div class="transcript">
<p><strong>Narrator:</strong> Welcome to this product demo.</p>
<p><strong>Narrator:</strong> On the left side of the screen,
you can see the dashboard showing monthly sales figures.</p>
<p>[Sound effect: notification chime]</p>
<p><strong>Narrator:</strong> A pop-up alert appears in the
top-right corner indicating a new message.</p>
</div>
</details>
<video controls width="640">
<source src="demo.mp4" type="video/mp4">
</video>
<!-- Transcript only covers dialogue, missing visual context -->
<p class="transcript">Welcome to this product demo.
A pop-up alert appears.</p>
Create a separate video version with integrated audio description
When the video’s original soundtrack has no natural pauses for a separate audio description track, produce a second version with description integrated directly into the audio. Offer both versions as choices for the user.
<video controls width="640">
<source src="tutorial.mp4" type="video/mp4">
<source src="tutorial-described.mp4" type="video/mp4">
Your browser does not support video playback.
<a href="transcript.html">View text transcript</a>
</video>
<p>
<a href="tutorial-described.mp4">
Download version with audio description
</a>
</p>
<video controls width="640">
<source src="tutorial.mp4" type="video/mp4">
</video>
<!-- No alternative version and no description -->
Verify transcript completeness and accuracy
Manually review the transcript against the video to ensure it captures all spoken content, sound effects, and visual information such as on-screen text, charts, and character actions. Auto-generated captions are insufficient for a complete media alternative.
<div class="transcript">
<p><strong>[00:00] Narrator:</strong> The bar chart shows
revenue increasing from $2 million to $5 million over four quarters.</p>
<p><strong>[00:05] Narrator:</strong> A green upward arrow
animates beside the Q4 figure.</p>
<p><em>[Upbeat background music fades out]</em></p>
</div>
<div class="transcript">
<p>Revenue increased.</p>
<p>Music plays.</p>
</div>
<!-- Vague and incomplete; misses key visual data and context -->
Known Limitations
- Manual-only rule – This rule does not perform any automated checking. It relies entirely on the developer or auditor to manually verify that audio description or a media alternative exists and is adequate. Automated tools cannot assess the quality or completeness of description content.
- JavaScript-generated video players – Video elements created or controlled by JavaScript (e.g., through custom or third-party players) may not be detected or may lack accessible controls for enabling audio description tracks.
- Shadow DOM encapsulation – If video content is embedded inside a shadow root, the standard selector may not find the elements, requiring deeper inspection of the component tree.
- Third-party embeds – Videos embedded from external platforms (e.g., YouTube, Vimeo) may appear as an
<iframe>rather than a native<video>element, and the rule will not scan inside the iframe. Manual verification of the embedded content is required. - Live video streams – This rule applies to pre-recorded content only. Live or real-time video streams fall under WCAG Success Criterion 1.2.4 (Audio Description – Live), which is Level AA.
Resources
- WCAG 2.2 Understanding Success Criterion 1.2.3
- W3C WAI: Making Audio and Video Media Accessible
- MDN: The <track> element
- W3C WebVTT: The Web Video Text Tracks Format
- Section 508: Video Captions and Audio Descriptions
Rule
- Audit: accessibility
- Standard: WCAG
- Level: A
- Success Criteria: 1.2.3
- Rule ID:
audio-description-or-media-alternative