CKTIS / HTML
`controlslist` on video and audio elements
`controlslist` is a hint for the browser’s built-in player. `nodownload` can hide a download option, while `noplaybackrate` is non-standard. Neither protects the media file.
Version: Non-standard media-controls extension; browser support varies
Syntax
<video controls controlslist="nodownload noplaybackrate"></video>
<audio controls controlslist="nodownload noplaybackrate"></audio>
The HTML Living Standard defines `controls` and `HTMLMediaElement.playbackRate`, not the `controlslist` attribute or the `HTMLMediaElement.controlsList` property. Those are a browser extension with limited support.
JavaScript, where supported: media.controlsList (DOMTokenList); media.controlsList.add("nodownload"). The token noplaybackrate is non-standard.On video and audio, the presence of the boolean controls attribute requests the browser’s built-in controls. controlslist does not turn those controls on: it supplies space-separated tokens to guide the browser’s choice of what to show. Where implemented, the JavaScript property media.controlsList returns a DOMTokenList you can edit, for example with media.controlsList.add("nodownload").
nodownload asks the browser to hide its built-in download option if it offers one. noplaybackrate is intended to hide the speed selector where recognized. It is non-standard and is not among the supported tokens listed by MDN. The HTML Living Standard defines controls and media.playbackRate, but not the controlslist attribute or the media.controlsList property. This extension has limited browser support. Reading the attribute text or detecting the property does not prove that a menu item was hidden. Test the actual controls in your target browsers and keep the player usable if the hint is ignored.
Hiding the speed selector does not lock media.playbackRate. Likewise, hiding the download option does not stop the browser from fetching the media data it needs for playback or prevent that data from being saved. controlslist is not a substitute for server-side access control and does not protect the file against copying.
Examples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Inspect media controls markup</title>
<video id="video" controls controlslist="nodownload noplaybackrate"></video>
<audio id="audio" controls controlslist="nodownload noplaybackrate"></audio>
<pre id="result"></pre>
<script>
const lines = ['video', 'audio'].map((id) => {
const media = document.getElementById(id);
return `${id}: controls=${media.controls}; controlslist=${media.getAttribute('controlslist')}`;
});
document.getElementById('result').textContent = lines.join('\n');
</script>
</html>Result
video: controls=true; controlslist=nodownload noplaybackrate audio: controls=true; controlslist=nodownload noplaybackrate
The two lines report `controls` and the attribute text. The example has no media sources and does not check which options are hidden.
Related lessons
- HTML · Lesson 11 · Advanced · Version: 2
Sources
- HTML Standard — User interface (standard native controls, not the controlslist extension)
- HTML Standard — Playing the media resource (standard playback behavior, including playbackRate)
- HTMLMediaElement: controlsList property (browser extension)
- <video>: The Video Embed element — controlslist attribute
- <audio>: The Embed Audio element — controlslist attribute
- Element: getAttribute() method