mediumBest Practices

Video Elements Missing Controls Attribute

Video elements without the controls attribute prevent users from playing, pausing, or muting videos.

By Seoxpert Editorial · Published Apr 28, 2026

Why it matters

Missing controls on video elements make content inaccessible, especially for users who rely on keyboard or touch navigation. This violates WCAG 2.1.1 and can negatively impact SEO by reducing user engagement and accessibility compliance.

Impact

Users may be unable to interact with video content, leading to poor accessibility and potential legal or SEO issues.

How it's detected

An automated crawler scans for <video> elements missing the 'controls' attribute in the HTML markup.

Common causes

•Developers forget to add the controls attribute.
•Custom video players are not implemented or are incomplete.
•Templates omit the controls attribute by default.
•Assumption that all users have alternative controls available.

How to fix it

Add the 'controls' attribute to every <video> element unless you provide fully accessible custom controls. For example: <video controls src="video.mp4">. Ensure any custom controls meet accessibility standards if you choose not to use the native attribute.

Code examples

Problem: Missing controls attribute

<video src="example.mp4"></video>

Fix: Add controls attribute

<video controls src="example.mp4"></video>

FAQ

Why is the controls attribute important for video elements?

It allows users to play, pause, and control video playback, which is essential for accessibility and usability.

Can I use custom controls instead of the native controls attribute?

Yes, but your custom controls must be fully accessible and provide equivalent functionality.

Does missing the controls attribute affect mobile users differently?

Yes, mobile users often lack keyboard or hover alternatives, making native controls essential for interaction.

Is this a WCAG violation?

Yes, missing controls on video elements violates WCAG 2.1.1 guidelines for accessible content.

Found this issue on your site?

Run a scan to see if Video Elements Missing Controls Attribute affects your pages.

Scan my website →