controlslist
The controlsList property of the HTMLMediaElement interface returns a DOMTokenList that helps the user agent select what controls to show on the media element whenever the user agent shows its own set of controls. The DOMTokenList takes one or more of three possible values: nodownload, nofullscreen, and noremoteplayback.
Browser support
| Feature | Desktop | Mobile | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 58 | 79 | | | 58 | | |
| HTML attribute | ||||||
controlslist | 58 | 79 | | | 58 | |
controlslist | 58 | 79 | | | 58 | |
Syntax
<video controls controlslist="nodownload nofullscreen noremoteplayback"
src="video.mp4">
</video>Live demo
Hide download control
Use controlslist tokens to hint which built-in controls should be suppressed.
Multiple control hints
Combine tokens such as nodownload, noplaybackrate, and nofullscreen.
Player policy card
Document why a product might limit built-in controls for a focused viewing flow.
Use cases
-
Enhance media playback
Use controlslist when audio, video, or responsive media needs better control or more capable browser behavior.
-
Deliver flexible assets
Apply controlslist to adapt media loading or presentation more closely to user context and device capability.
Cautions
- Test controlslist in your target browsers and input environments before depending on it as a primary behavior.
- Provide a fallback path or acceptable degradation strategy when support is still limited.
Accessibility
- Pair richer media behavior with captions, transcripts, controls, and loading behavior that remain understandable to all users.