controlslistLimited availability
The controlslist attribute for <audio> or <video> hides parts of the browser's built-in controls. For example, controlslist="nofullscreen" removes the button to play the video in fullscreen.
Not yet supported in all major browsers — check the table and provide a fallback.
Browser support
DesktopChrome
1–57Not supported
58+Supportedsince Apr 19, 2017
Current: 155Edge
12–18Not supported
79+Supportedsince Jan 15, 2020
Current: 154Firefox
✕Not supportedup to 157
Current: 157Safari
✕Not supportedup to 27
Current: 27MobileChrome Android
18–57Not supported
58+Supportedsince Apr 25, 2017
Current: 155Firefox Android
✕Not supportedup to 157
Current: 157Safari iOS
✕Not supportedup to 27
Current: 27How to use
Not supported in Firefox, Safari, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.
Example
Full syntax and examples are on MDN: controlsList.
Feature detection
JS · check before using
if ("controlslist" in document.createElement("audio")) {
// the controlslist attribute/property of <audio> is supported
}Documentation (MDN)
Specification
Sub-features
Support for each part of the feature (3). The overall table above shows when the whole feature works.
| Sub-feature | Chrome | Edge | Firefox | Safari | Chrome Android | Firefox Android | Safari iOS |
|---|---|---|---|---|---|---|---|
| HTMLMediaElement.controlsList | 58 | 79 | ✕ | ✕ | 58 | ✕ | ✕ |
| audio.controlslist | 58 | 79 | ✕ | ✕ | 58 | ✕ | ✕ |
| video.controlslist | 58 | 79 | ✕ | ✕ | 58 | ✕ | ✕ |