File formats

What is a VTT file? WebVTT subtitles explained

By SubtitleDock Updated 2 min read

A VTT file is a text file containing timed captions. The name comes from WebVTT, or Web Video Text Tracks. If you have downloaded a recording and a separate .vtt file, the recording contains the sound and picture; the VTT file tells a player which words to display and when.

What does a VTT subtitle file look like?

The file starts with WEBVTT. Each caption block, called a cue, has a start time, an end time and text. Blank lines separate the cues. WebVTT uses a period before milliseconds and UTF-8 text encoding. In this original example, the first caption appears at one second and ends at four seconds.

example.vtt
WEBVTT

00:00:01.000 --> 00:00:04.000
Welcome to the workshop.

00:00:04.500 --> 00:00:07.000
Let’s start with the first example.

How to open a VTT file

To read the words, open a copy in a plain-text editor. To view timed captions, load it alongside the matching video in a player that accepts WebVTT. Opening the subtitle file on its own does not play a video.

For a readable transcript without timecodes, use Subtitle to Text. It removes the cue structure while keeping the words and their order. Keep the original VTT if you will need synchronized captions later.

When should you convert VTT to SRT?

Use the format your destination player or editor requests. If it asks for SubRip subtitles, convert the VTT file to SRT. Renaming .vtt to .srt leaves the internal syntax unchanged and can lead to an import error.

SubtitleDock keeps caption text and cue times during conversion. It removes styling, positioning and speaker annotations, and shows conversion notes. Review those notes if placement or speaker information matters to your recording.

Why might a VTT file fail to open?

Check for a missing WEBVTT header, an end time before a start time, or missing blank lines between cues. Save the file as UTF-8 plain text rather than a word-processing document. SubtitleDock reports malformed subtitle blocks so you can correct the source and try again.

If the words are correct but appear consistently early or late, conversion will not fix the delay. Use a timing adjustment on the original subtitles instead. If there are no words because you only have a recording, start with Video to Text.

Subtitle guides

View all guides

Understand the formats, follow an example, and choose your next step.

Practical guides 3 min read

How to fix subtitles that are out of sync

Shift SRT or VTT subtitles earlier or later with the correct offset. Learn the difference between a constant subtitle delay and gradual timing drift.