HTML controlslist Attribute: Reference and Examples

The controlslist attribute is a small instruction attached to an HTML element. Its job is to hint which playback controls to suppress; uneven support. It is easier to remember when you can see it in a real piece of markup.

What controlslist is used for

Hint which playback controls to suppress; uneven support. The attribute appears inside an element’s opening tag. Depending on its definition, it may take a specific string, a number, an enumerated keyword, or be a boolean attribute.

The example below uses it in a video context. Other elements may support it too, or may give the same attribute a different meaning.

Example you can try

<video controls controlslist="nodownload" width="640">
    <source src="lesson.mp4" type="video/mp4">
    <p>Video unavailable.</p>
</video>

How the example works

Look for controlslist in the snippet. Here the example shows the value nodownload. This is a concrete input the browser can interpret; it is not just text shown to the reader.

Controlslist is a browser hint and does not reliably prevent someone from downloading the actual media file.

Values and important behavior

Typical values include nodownload, nofullscreen, and noremoteplayback. They are hints rather than security barriers.

This detail matters most when the page receives user input, navigates to another document, or loads an external resource. In those cases, check the browser behavior and any server-side requirements separately.

Small practice task

Copy the code and change controlslist to another sensible value, or remove it entirely if it is optional. Test the difference in the browser and inspect any submitted value or network request.

Common Beginner Mistakes

• Controlslist is a browser hint and does not reliably prevent someone from downloading the actual media file.
• Using controlslist on an element that does not support it.
• Believing that an HTML hint or client-side check replaces real server validation or a security policy.

Key Takeaways

• controlslist is used to hint which playback controls to suppress; uneven support.
• Controlslist is a browser hint and does not reliably prevent someone from downloading the actual media file.
• Choose valid values and test the result instead of guessing what the browser will do.