HTMLTrackElement: kind property

Baseline Widely available

This feature is well established and works across many devices and browser versions. Its been available across browsers since July 2015.

Learn more
See full compatibility

The kind property of the HTMLTrackElement interface represents the type of track, or how the text track is meant to be used. It reflects the <track> element's enumerated kind attribute.

If no kind is set, subtitles is used. If the attribute is not set to one of the valid enumerated values, it is invalid and metadata is used. Other valid values include captions, descriptions, and chapters.

Value

A string; lowercase captions, descriptions, chapters, subtitles or metadata.

Example

Given the following:

html

<track src="track.vtt" id="exampleTrack" />

We get the following results:

const trackElement = document.getElementById("exampleTrack");
// missing value
console.log(trackElement.kind); // "subtitles"
trackElement.kind = "INVALID";
// invalid value
console.log(trackElement.kind); // "metadata"
trackElement.kind = "CAPTIONS";
// valid value
console.log(trackElement.kind); // "captions"

Specifications

Specification
HTML # dom-track-kind

Browser compatibility

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Apr 10, 2025 by MDN contributors.

View this page on GitHub Report a problem with this content