What is a VTT file?
WebVTT: Web Video Text Tracks
Updated
A VTT file (.vtt, WebVTT) is a plain-text caption file for web video. It starts with the line WEBVTT, followed by cues with HH:MM:SS.mmm timestamps (a dot, not a comma) and the caption text. Browsers use it for HTML5 <video> captions, and Zoom and Teams use it for meeting transcripts.
In depth
WebVTT stands for Web Video Text Tracks. It is the caption format of the web: the W3C specification (a Candidate Recommendation since 2019) grew out of SRT, and it is the only caption format that browsers load natively through the HTML5 <track> element. A .vtt file contains no video or audio, only text and timing, so you can open it in any text editor. It looks almost like SRT, with three visible differences: the file must begin with WEBVTT, milliseconds are separated with a dot (00:00:01.500), and cue numbers are optional. On top of that it adds things SRT lacks: cue settings for position and alignment, CSS styling, speaker voice tags, comments and per-word timestamps. Most people meet VTT files in one of three places: captions downloaded from a website or YouTube, a meeting transcript from Zoom or Microsoft Teams, or a streaming (HLS) video's subtitle track.
VTT file format
- Header: the first line is exactly WEBVTT (optionally followed by a space and a title). A file without it is not valid WebVTT.
- A blank line.
- Cues, each made of: an optional identifier line (a number or name), a timing line start --> end with optional cue settings after it, then one or more text lines.
- A blank line after every cue.
| Element | Syntax | What it does |
|---|---|---|
| Timestamp | 00:01:02.500 or 01:02.500 | Hours are optional; a dot comes before the 3-digit milliseconds |
| Cue settings | line:85% position:50% align:center size:80% | Vertical position, horizontal position, alignment and box width |
| Voice tag | <v Maria>Hi there</v> | Marks the speaker |
| Inline tags | <i> <b> <u> <c.yellow> | Italic, bold, underline, CSS class |
| Word timing | <00:00:02.100>word | Highlights words as they are spoken (karaoke style) |
| Comment | NOTE text | A comment the player ignores |
| Style block | STYLE ::cue { color: yellow } | CSS for the captions, placed before the first cue |
| Encoding / MIME | UTF-8, text/vtt | Files must be UTF-8; servers should send text/vtt |
VTT file example
WEBVTT NOTE Sample captions for a product demo 1 00:00:00.500 --> 00:00:02.800 <v Host>Welcome back to the channel. 2 00:00:03.000 --> 00:00:06.200 line:10% align:center This line sits at the top of the frame. 3 00:00:06.600 --> 00:00:09.000 <v Guest><i>It's</i> just a text file. intro-end 00:01:05.250 --> 00:01:08.000 Thanks for watching!
VTT vs SRT
| VTT (WebVTT) | SRT | |
|---|---|---|
| First line | WEBVTT (required) | Cue number 1 |
| Millisecond separator | Dot: 00:00:01.000 | Comma: 00:00:01,000 |
| Cue numbers | Optional, can be names | Required |
| Positioning and styling | Yes: cue settings and CSS | No official support |
| Plays in HTML5 <video> | Yes, natively | No, convert to VTT first |
| Accepted by YouTube, Vimeo, VLC | Yes | Yes |
| Facebook caption upload | No (SRT only) | Yes |
| Video editors (Premiere, Resolve, Final Cut, CapCut) | Some | All of them |
Rule of thumb: use VTT for your own website's player and streaming; use SRT for everything you upload or import. Converting between them only changes the header and the comma/dot, so it is lossless for text and timing.
How to open a VTT file
- Read or edit it: right-click > Open with > Notepad (Windows), TextEdit (Mac) or any code editor. It is plain UTF-8 text.
- Watch it with the video: in VLC choose Subtitle > Add Subtitle File, or name it like the video (talk.mp4 + talk.vtt) in the same folder.
- Get just the words: a Zoom or Teams transcript .vtt is full of timestamps; convert VTT to TXT to keep only the spoken text, or open it in Word after converting.
- Use it on a website: <video src="talk.mp4"><track kind="captions" src="talk.vtt" srclang="en" label="English" default></video>. If the .vtt is on another domain, the server must allow CORS.
- Edit it visually: open it in a subtitle editor that shows cues as rows, such as the SoCaptions SRT editor, Subtitle Edit or Aegisub.
How to create a VTT file
Write it in a plain-text editor (WEBVTT on line one, then cues) and save it as UTF-8 with a .vtt extension, or generate it from the video: the SoCaptions SRT generator transcribes speech with Whisper in 99 languages and downloads either .srt or .vtt. Downloads are free; the first 5 minutes of transcription are free.
Common VTT errors
- Captions don't show in the browser: the first line isn't exactly WEBVTT, the file is served with the wrong MIME type (it must be text/vtt), or a cross-origin file is blocked by CORS.
- A platform rejects the file: it probably only takes SRT. Convert VTT to SRT and upload again.
- Garbled characters: the file isn't UTF-8. Re-save it as UTF-8.
- Commas in timestamps (00:00:01,000): that is SRT syntax and invalid in WebVTT; use dots.
- Cue settings ignored: some players (and most social platforms) ignore position and alignment; burn captions in if placement matters.
When to use it
Use VTT when captions play in a browser: HTML5 <video> on your own site, a custom web player, or an HLS stream. YouTube and Vimeo accept VTT uploads too. For uploads to Facebook, LinkedIn and most video editors, and for maximum compatibility, use SRT instead.
Frequently asked
What is a VTT file used for?+
Captions and subtitles for web video. Browsers load VTT through the HTML5 <track> element, streaming services use it for subtitle tracks, and Zoom and Microsoft Teams save meeting transcripts as .vtt files.
How do I open a VTT file?+
With any text editor (Notepad, TextEdit, VS Code) to read the text, or with VLC (Subtitle > Add Subtitle File) to watch it over the video. To get plain text without timestamps, convert VTT to TXT.
Is VTT the same as SRT?+
Nearly. Both are plain-text cue lists, but VTT starts with a WEBVTT line, uses a dot before the milliseconds, makes cue numbers optional, and supports positioning and styling. Converting between them is lossless for text and timing.
Why does WebVTT use dots and not commas?+
WebVTT follows web and ISO 8601 conventions, which use a dot as the decimal separator. SRT's comma comes from the European locale of the original SubRip software.
What are cue settings?+
Optional key:value pairs after the timestamp, for example line:90% (vertical position), position:50% (horizontal), align:center and size:80%. They move captions away from the default bottom-centre position.
Can VTT files be styled with CSS?+
Yes. The ::cue pseudo-element targets WebVTT text, so site CSS (or a STYLE block inside the file) can change font, colour and background.
Can I upload a VTT file to YouTube?+
Yes. YouTube Studio > Subtitles > Add language > Upload file > With timing accepts .vtt as well as .srt.
An SRT file (.srt) is a plain-text subtitle file: numbered cues, each with a start and end time in HH:MM:SS,mmm format and the caption text, separated by blank lines. It is the most widely supported subtitle format, read by YouTube, VLC, Premiere, CapCut and almost every other player and editor.
A heavily-styled subtitle format used by Aegisub and the anime fansub community. Supports per-cue fonts, colors, positioning, and karaoke timing.
Captions that the viewer can toggle on or off, typically delivered as a separate text track encoded into or alongside the video.
Hardcoded subtitles — also called burned-in subtitles or open captions — are permanently rendered into the video pixels — identical on every player and platform, but viewers can't turn them off. Required for TikTok, Reels, and Shorts where caption tracks are hidden during feed autoplay.