HTML controls Attribute

The controls attribute is a boolean attribute."

Definition and Usage

The controls attribute is a boolean attribute.

When present, it specifies that audio/video controls should be displayed.

Controls should include:

  • Play
  • Pause
  • Seeking
  • Volume
  • Fullscreen toggle (for video only)
  • Captions/Subtitles (for video only, when available)
  • Track (for video only, when available)
  • Applies to

    The controls attribute can be used on the following elements:

    Elements Attribute
    <audio> controls
    <video> controls

    Examples

    Audio Example

    An <audio> element with browser default controls:

    <audio controls>
      <source src="horse.ogg" type="audio/ogg">
      <source src="horse.mp3" type="audio/mpeg">
      Your browser does not support the audio element.
    </audio>

    Video Example

    A <video> element with browser default controls:

    <video controls>
      <source src="movie.mp4" type="video/mp4">
      <source src="movie.ogg" type="video/ogg">
      Your browser does not support the video tag.
    </video>

    Browser Support

    The controls attribute has the following browser support for each element:

    Element
    audio 4.0 9.0 3.5 4.0 10.5
    video 4.0 9.0 3.5 4.0 10.5