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

  1. Header: the first line is exactly WEBVTT (optionally followed by a space and a title). A file without it is not valid WebVTT.
  2. A blank line.
  3. 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.
  4. A blank line after every cue.
ElementSyntaxWhat it does
Timestamp00:01:02.500 or 01:02.500Hours are optional; a dot comes before the 3-digit milliseconds
Cue settingsline: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>wordHighlights words as they are spoken (karaoke style)
CommentNOTE textA comment the player ignores
Style blockSTYLE ::cue { color: yellow }CSS for the captions, placed before the first cue
Encoding / MIMEUTF-8, text/vttFiles 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!
sample.vtt: header, a NOTE comment, speaker voice tags, a cue moved to the top with cue settings, and a named cue identifier.

VTT vs SRT

VTT (WebVTT)SRT
First lineWEBVTT (required)Cue number 1
Millisecond separatorDot: 00:00:01.000Comma: 00:00:01,000
Cue numbersOptional, can be namesRequired
Positioning and stylingYes: cue settings and CSSNo official support
Plays in HTML5 <video>Yes, nativelyNo, convert to VTT first
Accepted by YouTube, Vimeo, VLCYesYes
Facebook caption uploadNo (SRT only)Yes
Video editors (Premiere, Resolve, Final Cut, CapCut)SomeAll 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.

Free converter
VTT to SRT: convert in your browser, nothing uploaded
Free converter
SRT to VTT: make a caption file for HTML5 <video>

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.
Free converter
VTT to TXT: strip timestamps from a Zoom or Teams transcript
Free tool
Subtitle editor: open and fix SRT or VTT files in the browser

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.

Free tool
Generate an SRT or VTT file from any video

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.

Related terms
Full comparison
SRT vs VTT vs ASS: compatibility table and a 4-question decision tree for picking the right format.
Skip the file-format gymnastics.
Drop a video into the SoCaptions editor — get ready-to-publish captions in any format.
Try free