Skip to main content

Word

Word defines the timing for one word inside a subtitle caption.

Location: payload.subtitle.captions[n].words[m]. Both timestamps use absolute project seconds, not seconds relative to the caption. Keep start < end, words in chronological order, and each interval inside the parent caption's interval. A caption beginning at 5 seconds has word times such as 5.0–5.4, not 0.0–0.4.

interface Word {
start: number;
end: number;
text: string;
}
PropertyRequiredNotes
startYesWord start time in seconds.
endYesWord end time in seconds.
textYesWord text.

Word timings drive the word-timed subtitle animations (one-word, karaoke, highlight, progressive, fill, pop, bounce, fade, typewriter, slide). Words are optional on a caption — when omitted, timings are auto-distributed from the caption text.

Used By​