Install your player · WhatsApp us for a one-day free trial

The 8K IPTV journal

WebVTT subtitles: text cues with timing and placement

WebVTT is a timed-text format used with web media. It can carry cues and presentation information that a compatible player displays alongside video. Seeing a VTT file does not guarantee a particular language, translation quality or accessibility completeness; those depend on the actual caption content.

Illustrated guide: WebVTT subtitles: text cues with timing and placement
What is a WebVTT subtitle file?

WebVTT is a timed-text format used with web media. It can carry cues and presentation information that a compatible player displays alongside video. Seeing a VTT file does not guarantee a particular language, translation quality or accessibility completeness; those depend on the actual caption content.

Understand the separate track

A text track can be enabled, disabled and styled where the player supports those controls. This differs from captions burned into the video pixels. The browser or application must retrieve and parse the track successfully, so video playback can work while the text fails because of a separate delivery or formatting problem.

Inspect the visible behaviour

If captions never appear, check that the intended track is selected and try another available language. If only some lines are misplaced, cue positioning or player handling may be involved. A complete absence, a timing offset and unreadable text are different symptoms and should be described separately.

Use support information safely

For a website you manage, a developer can inspect the caption request and formatting using appropriate tools. As a viewer, report the title, app, language and time without posting private media URLs. Do not assume changing the video resolution will repair a text track that is missing or malformed.

Questions about this topic

Is WebVTT an audio codec?
No. It describes timed text, not sound compression.
Can a VTT track contain non-speech sound cues?
Yes. Its usefulness depends on what the caption author included.

Sources & further reading

Keep reading

Related guides.

Illustrated guide: Captions versus subtitles: choosing the text a viewer needs

Captions versus subtitles: choosing the text a viewer needs

Captions convey dialogue and relevant non-speech sound, such as a doorbell, music or speaker identification. Subtitles often focus on dialogue or translation. The terms are used inconsistently across apps, so inspect the actual track and choose the version that provides the information the viewer needs.

Explore guide ↗
Illustrated guide: Audio language and subtitle language are separate choices

Audio language and subtitle language are separate choices

Audio and subtitles are separate tracks with their own selections and availability. Changing one does not necessarily change the other. A player’s preferred-language setting may guide automatic choices, but the programme must actually contain a matching track for that preference to be satisfied.

Explore guide ↗

Your next screen starts here

Installed your player?

WhatsApp us for a one-day free trial. Tell us your device and the player you installed so we can help you get connected.

WhatsApp support