W3cubDocs

/Web APIs

VTTCue: text property

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

* Some parts of this feature may have varying levels of support.

The text property of the VTTCue interface represents the text contents of the cue.

Value

A string containing the raw text of the cue.

Examples

In the following example a new VTTCue is created, then the value of size is set to the string "new cue value". The value is then printed to the console.

let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";

let cue = new VTTCue(0, 0.9, "Hildy!");
cue.text = "new cue value";
console.log(cue.text); // 'new cue value';

track.addCue(cue);

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
text 23 12 31 ≤12.1 6 25 31 ≤12.1 8 1.5 4.4 8
all_html_character_references 63 79 127 50 17.5 63 127 46 17.5 8.0 63 17.5

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/VTTCue/text