What is a VTT file, and how do you use one?
You have a .vtt file and want to know what to do with it. Here is what is inside one, how to open, make, edit and convert it, and how it differs from SRT.

A VTT file is a WebVTT (Web Video Text Tracks) caption file: plain UTF-8 text that starts with the word WEBVTT and then lists timed cues telling a player what to show and when. Web browsers load it through the HTML track element, which is the main job the format was built for. It looks a lot like SRT, but it writes times with a full stop and can also carry position and styling settings.
What is inside a VTT file
A VTT file is plain text with the .vtt extension. The W3C WebVTT specification says it must be encoded as UTF-8 and labelled with the media type text/vtt. Here is a short, complete file for a workshop video.
WEBVTT
NOTE Captions for the oak worktop video, first cut.
intro
00:00:01.000 --> 00:00:03.500
Welcome back to the workshop.
00:00:03.800 --> 00:00:06.200
Today we fit the new <i>oak</i> worktop.
warning
00:00:06.500 --> 00:00:09.000 line:10% align:center
<v Dana>Mind the saw, it is still running.</v>
00:00:09.200 --> 00:00:12.000
Oil & wax go on last.
The header and the cues
The first line must be the word WEBVTT. A space and a short title may follow it, as in WEBVTT Workshop captions, and a blank line comes next. A file that holds only WEBVTT is valid, just empty.
Each cue after the header is one caption: a timing line, the text, and a blank line that ends it. Times are written as 00:01:05.250, with a full stop before exactly three digits of milliseconds. The hours may be dropped while they are zero, as in 01:05.250, and no cue may start before the one above it.
The line above a timing, such as intro or warning, is an optional cue identifier, and the W3C specification asks for each one to be unique. A block that starts with NOTE is a comment that players do not show.
Cue settings: where the caption sits
Settings after the end time place the caption, written as name:value. In the sample, line:10% lifts the warning near the upper edge of the frame.
- line: how high or low the caption sits, as a line number or a percentage.
- position: the horizontal spot, as a percentage of the frame width.
- size: the width of the caption box.
- align: the start, center or end of that box.
- vertical: rl or lr, for vertical text.
Styling tags
Inside the text, <b>, <i> and <u> give bold, italic and underline, <v Dana> marks a speaker, and timestamps such as <00:00:05.000> allow karaoke-style captions. Colours and fonts go in a STYLE block of CSS before the first cue. Only a few CSS properties apply to captions, such as color, background, font and text-shadow.
Write & as & and < as < in caption text, and MDN recommends > for >. The ‎ and ‏ escapes add direction marks for lines that mix Arabic or Hebrew with English. Our RTL fixer is built for those files.
Where VTT files are used
The W3C gives the main use of WebVTT as text tracks for the HTML track element, which attaches captions to a video on a web page. The HTML standard names five kinds of track:
- subtitles: a transcription or translation of the dialogue, for when the sound is available but not understood.
- captions: the dialogue plus sound effects and other relevant audio, for when the sound is unavailable or unclear.
- descriptions: text descriptions of the picture, meant to be read aloud by speech synthesis.
- chapters: chapter titles a page can use for navigation.
- metadata: data for scripts, not shown to viewers.
For words that viewers read on screen, choose subtitles or captions. If you are not sure which one fits your file, our guide to subtitles vs captions explains the difference.
WebVTT also works outside web pages. RFC 8216, the HTTP Live Streaming (HLS) specification, carries subtitles as WebVTT segments, and the Matroska container can store a WebVTT track with its cue settings and notes.
Meeting tools use the format for transcripts too. Zoom's help pages list a VTT file that holds the audio transcript of a cloud recording, and Microsoft Teams lets meeting organizers download a transcript as .docx or .vtt. To read one as plain text, our VTT to TXT tool turns it into a .txt file.
VTT compared with SRT and ASS
SRT is the older, simpler format that WebVTT grew from. ASS, short for Advanced SubStation Alpha, adds named styles, exact positions and animation.
| SRT | VTT | ASS | |
|---|---|---|---|
| First line | The cue number 1 | The word WEBVTT | The [Script Info] section |
| Time format | 00:02:17,440 (comma) | 00:02:17.440 (full stop) | 0:02:17.44 (hundredths of a second) |
| Text styling | Bold, italic, underline, colour; varies by player | Tags for bold, italic, voices, classes; CSS | Named styles plus override tags in braces |
| Positioning | No standard setting | Cue settings: line, position, size, align | Alignment, margins and \pos coordinates |
| Typical use | Plain subtitles with no layout needs | Web pages with the track element, HLS streams | Styled, placed or animated subtitles |
SRT has no fixed encoding: the Library of Congress notes that SubRip saved Windows-1252 by default, while WebVTT must be UTF-8. An ASS file can hold things VTT cannot express, such as moving text and fades, so check a converted file by eye. There is more in subtitle file formats and what is an SRT file.
Three ways to create a VTT file
Write one by hand
For a short clip, a text editor is enough. Type WEBVTT, leave a blank line, then add each cue: timing line, text, blank line. Play the video, note when each line starts and ends, and save the file as UTF-8 with a .vtt extension.
Keep each caption short enough to read while it is on screen. Our guide to subtitle timing and reading speed goes into the numbers.
Export one from a caption editor
The Vid Hub caption editor runs in your browser at vid-hub.com, and no account is needed to start. It writes captions from the speech in your video: captions for up to 10 minutes of a video free, and for up to 20 minutes of a video on paid plans. You can then edit every caption's text and timing.
On a paid plan, the arrow beside Export downloads the captions as .vtt, .srt or .txt. The VTT file escapes &, < and > and leaves out empty captions.
Convert an SRT file
The Library of Congress notes that SRT was the basis for WebVTT, so a conversion takes only four changes:
- Add WEBVTT as the first line, then a blank line.
- Change the comma before the milliseconds to a full stop: 00:00:03,500 becomes 00:00:03.500.
- Write any & in the text as & and any < as <.
- Save as UTF-8 with the .vtt extension. The cue numbers can stay as identifiers.
SRT:
1
00:00:01,000 --> 00:00:03,500
Welcome back to the workshop.
VTT:
WEBVTT
1
00:00:01.000 --> 00:00:03.500
Welcome back to the workshop.
Our free SRT to VTT converter does this in your browser, and VTT to SRT goes the other way. The subtitle converter reads SRT, VTT, SBV and ASS files and writes SRT, VTT, SBV, TXT or ASS.
Opening and editing a VTT file
Any plain text editor opens a VTT file. Avoid word processors, which can add their own formatting. If you must use one, save as plain text in UTF-8.
Keep a copy of the original file before you start, so you can go back if a change breaks it. When you edit, keep the WEBVTT line, a blank line between cues and a space on each side of the arrow. Words are safe to change, but times must keep the exact pattern.
For a visual way to work, open the file in our free subtitle editor, which edits SRT and VTT files in your browser. Our guide to subtitle formatting rules covers line length and line breaks.
Putting a VTT file on a video
On your own web page
<video controls src="workshop.mp4">
<track kind="captions" src="workshop-en.vtt" srclang="en" label="English" default>
<track kind="subtitles" src="workshop-es.vtt" srclang="es" label="Spanish">
</video>
The track element goes inside the video element. src points to the file, kind says whether it holds captions or subtitles, srclang gives the language, and label is the name viewers see in the track list. default turns a track on unless the viewer's settings ask for another. Add one track per language, each with its own srclang and label.
On a hosting platform
Look in the platform's upload or settings page for a captions or subtitles option. Check its help pages for the file types it accepts, and if it wants SRT, convert first with VTT to SRT.
Burned into the picture
Burning in draws the captions into the video frames, so they show wherever the video plays, but viewers cannot turn them off. Vid Hub exports an MP4 with the captions burned in, and the free export is 480p with a vid-hub.com mark. Our guide to burned-in vs soft subtitles helps you choose.
Making VTT captions accessible
For viewers who cannot hear the audio, set kind to captions and write to match. In the HTML standard, captions carry sound effects and other relevant audio as well as dialogue. Add lines such as [drill whirring], and make clear who is speaking, for example Dana: Mind the saw.
Vid Hub writes captions from speech, but it does not add speaker names or sound descriptions by itself. You can type them into any caption. Read more in subtitles vs captions and video accessibility and captions.
When a VTT file does not work
The captions do not load at all
Check the first line. The file must begin with WEBVTT, optionally after a byte order mark, followed by a space, a tab or a line break. With a blank line above it, or WEBVTT: with a colon, the parser does not process the file.
Some captions are missing
Check the times of those cues. The parser needs a full stop before the milliseconds, two digits for seconds and three for milliseconds, so 00:00:03,500 or 00:00:03.5 makes it skip the cue. Each cue must also end after it starts. Search hand-converted SRT files for stray commas.
Letters show up as odd symbols
The parser reads a VTT file as UTF-8, so a file saved as Windows-1252 can turn accented letters into odd symbols. Save it again as UTF-8.
Text with & or < in it
A bare & or < is not allowed in caption text. Write Salt & pepper, not Salt & pepper.
The captions load but do not show
Turn captions on in the player first. On a web page, a track without the default attribute stays off until the viewer picks it, and the HTML standard requires srclang on any subtitles track.
The track fails on your website
Under the HTML standard, the browser judges a track file's type from what the server sends, and a track of an unsupported type fails to load. Ask your host to serve .vtt files as text/vtt.
The VTT file is on another domain
A track file on a different domain loads only when the video element has a crossorigin attribute and that server allows your site with an Access-Control-Allow-Origin header. If either is missing, the track fails to load.
The captions are out of sync
If every caption is off by the same amount, our subtitle shifter moves all the times earlier or later. If the gap changes along the video, one shift will not fix it. Making fresh captions from the speech in the caption editor is another route.
Frequently asked questions
Which program opens a .vtt file?
Any plain text editor will, because the file is only text. To check the captions against the video, open it in our free subtitle editor in your browser.
Can I turn VTT captions into an SRT file?
Yes, and the free VTT to SRT tool does it in your browser. By hand, delete the WEBVTT line and any notes, number the cues, change the full stop in each time to a comma, and remove cue settings.
What is the difference between VTT and SRT?
VTT opens with a WEBVTT header, writes times with a full stop where SRT uses a comma, and must be saved as UTF-8. It also supports cue settings for placement, NOTE comments and CSS styling.
Can I rename an .srt file to .vtt?
Not on its own. The renamed file still lacks the WEBVTT first line, so it is not processed, and its comma times would make its cues fail. Use the free SRT to VTT converter, or add the header and swap the commas by hand.
Why are my VTT captions not showing?
Check that captions are turned on in the player and that the file starts with WEBVTT. On a website, also check that the server sends the file as text/vtt and that a file on another domain is allowed by CORS.
Can a VTT file set caption colour and position?
Yes. Cue settings such as line and position place each caption, and a STYLE block sets colour and font. MDN notes that some styling features are not supported in the main browsers, so test before you publish.
How do I make a VTT file from a video?
Upload the video to the Vid Hub caption editor, which writes captions from the speech for you to correct. Downloading them as a .vtt file needs a paid plan.
Do VTT cues need numbers?
No. Cue identifiers are optional, so a cue can start with its timing line. Numbers left over from an SRT file do no harm.
Try it on your own video
Open the editor, add your video, and get captions you can edit, style and export.
Upload your videoNo account needed to start.
Sources
We read each page below on the date shown. Rules, prices and plans change, so check the page itself before you rely on it. A source we cite does not endorse Vid Hub.
- W3C: WebVTT: The Web Video Text Tracks FormatRead 2026-11-07.
- MDN: Web Video Text Tracks Format (WebVTT)Read 2026-11-07.
- MDN: <track>: The Embed Text Track elementRead 2026-11-07.
- WHATWG: HTML Standard, media elements and the track elementRead 2026-11-07.
- MDN: Adding captions and subtitles to HTML videoRead 2026-11-07.
- MDN: Cross-Origin Resource Sharing (CORS)Read 2026-11-07.
- Library of Congress: SubRip Subtitle format (SRT)Read 2026-11-07.
- Matroska: SubtitlesRead 2026-11-07.
- Aegisub: ASS override tagsRead 2026-11-07.
- IETF: RFC 8216, HTTP Live StreamingRead 2026-11-07.
- Zoom Support: Understanding recording file formatsRead 2026-11-07.
- Microsoft Support: Start, stop, and download live transcripts in Microsoft Teams meetingsRead 2026-11-07.


