Skip to main content
Checks that videos have captions or transcripts
Rule IDa11y/video-captions
CategoryAccessibility
ScopePer-page
Severitywarning
Weight5/10

​
Solution

All video content needs captions for deaf/hard-of-hearing users (WCAG 1.2.2). Add <track kind='captions' src='captions.vtt' srclang='en'> to video elements. For embedded videos (YouTube, Vimeo), enable captions in the embed settings. Also provide a text transcript for complex content. Auto-generated captions should be reviewed for accuracy.

​
Enable / Disable

​
Disable this rule

squirrel.toml
[rules]
disable = ["a11y/video-captions"]

​
Disable all Accessibility rules

squirrel.toml
[rules]
disable = ["a11y/*"]

​
Enable only this rule

squirrel.toml
[rules]
enable = ["a11y/video-captions"]
disable = ["*"]