What is a VTT File? Everything You Need to Know About WebVTT

What is a VTT File?

A VTT file — formally known as a WebVTT (Web Video Text Tracks) file — is a plain text file used to display timed text content alongside video or audio. It is the standard subtitle and caption format for the web, developed and maintained by the W3C (World Wide Web Consortium) as part of the HTML5 specification. VTT files use the .vtt file extension and can be opened with any text editor.

If you have ever watched a video in a web browser with subtitles enabled, there is a good chance those subtitles were delivered using a VTT file. The HTML5 <track> element was designed to work specifically with WebVTT, making it the native subtitle format for every modern web browser including Chrome, Firefox, Safari, and Edge.

Unlike older subtitle formats that were built for desktop media players, WebVTT was created from the ground up for the internet. It supports features that matter on the web — CSS-based styling, precise positioning, metadata, and seamless integration with JavaScript — while remaining simple enough that anyone can read and edit the raw file in a text editor.

How Is a VTT File Structured?

A VTT file has a clean, human-readable structure. Every valid WebVTT file must start with the text WEBVTT on the very first line. After the header, the file contains a series of cues — individual subtitle entries that each specify when text should appear and disappear on screen.

Each cue consists of three parts:

1. Cue identifier (optional) — A label for the cue, which can be a number or a descriptive name. This is optional and is mainly useful for referencing specific cues in JavaScript.
2. Timestamp line — The start and end times separated by an arrow (-->). Timestamps use the format HH:MM:SS.mmm with a period (not a comma) as the millisecond separator.
3. Cue text — The subtitle text to display. This can span multiple lines.

Here is a complete example of a valid VTT file:

WEBVTT

1
00:00:01.000 --> 00:00:04.500
Welcome to this video about WebVTT files.

2
00:00:05.000 --> 00:00:08.200
We will cover everything you need to know
about the VTT subtitle format.

3
00:00:09.000 --> 00:00:12.800
Let us start with the basics of how
this format works.

A few important details about the format:

• The WEBVTT header is mandatory. Without it, browsers and video players will reject the file.
• There must be at least one blank line between the header and the first cue, and between each subsequent cue.
• The hours portion of the timestamp is optional for videos shorter than one hour — 00:01.000 is valid and equivalent to 00:00:01.000.
• Cue identifiers (the numbers above the timestamps) are optional. The file works perfectly without them.
• The file must be saved with UTF-8 encoding to properly handle international characters.

Key Features of VTT Files

What sets WebVTT apart from simpler subtitle formats like SRT is its rich set of features designed for web use. These capabilities make VTT the preferred format for any web-based video project.

CSS Styling Support

VTT supports inline styling tags that let you control the appearance of your subtitle text. You can use familiar HTML-like tags to apply formatting:

WEBVTT

00:00:01.000 --> 00:00:04.000
This is <b>bold</b> and this is <i>italic</i>.

00:00:05.000 --> 00:00:08.000
<c.yellow>This text appears in yellow.</c>

00:00:09.000 --> 00:00:12.000
<v Speaker 1>Hello, how are you?</v>

The supported tags include:

• <b> — Bold text
• <i> — Italic text
• <u> — Underlined text
• <c> — Apply a CSS class for custom colors and styles (e.g., <c.yellow>)
• <v> — Voice tag to identify the speaker (e.g., <v John>)
• <lang> — Specify the language of a text segment

When combined with a CSS stylesheet on your webpage, the <c> class tag gives you full control over subtitle appearance — font family, size, color, background, shadow, and more.

Cue Settings for Positioning and Alignment

VTT cues can include settings on the timestamp line that control exactly where and how subtitles appear on screen:

WEBVTT

00:00:01.000 --> 00:00:04.000 position:10% align:start
This text appears on the left side.

00:00:05.000 --> 00:00:08.000 line:0 align:center
This text appears at the top of the video.

00:00:09.000 --> 00:00:12.000 vertical:rl
This text displays vertically.

Available cue settings include:

• vertical — Display text vertically (rl for right-to-left, lr for left-to-right). Useful for East Asian languages.
• line — Vertical position of the cue on screen (by line number or percentage).
• position — Horizontal position of the cue (as a percentage).
• size — Width of the cue box (as a percentage of the video width).
• align — Text alignment within the cue box (start, center, end, left, right).

Notes and Metadata

VTT files can include comments using the NOTE keyword. Notes are not displayed to viewers — they are useful for leaving internal annotations, credits, or instructions for translators:

WEBVTT

NOTE This file was generated by Captain Transcribe.
NOTE Last updated: March 2026

00:00:01.000 --> 00:00:04.000
Welcome to our video.

How to Create a VTT File

There are three practical methods for creating VTT files, ranging from fully automated to fully manual.

Method 1: Use an AI Transcription Tool (Fastest)

The fastest way to create a VTT file is to use an AI-powered transcription service. Captain Transcribe lets you upload any video or audio file, select your language, and download a properly formatted VTT file in under a minute. The AI generates accurate timestamps and natural subtitle segmentation automatically, saving you hours of manual work. You can choose from three subtitle styles — Standard, Short, or Karaoke — depending on your content type, and export as VTT with a single click.

Method 2: Create Manually in a Text Editor

You can create a VTT file from scratch using any plain text editor — Notepad on Windows, TextEdit on Mac (in plain text mode), VS Code, Sublime Text, or any other editor you prefer. Start with the WEBVTT header, leave a blank line, then add your cues following the format described above. Save the file with the .vtt extension and make sure the encoding is set to UTF-8. Manual creation gives you complete control but is extremely time-consuming — expect to spend several hours per hour of video content as you watch, pause, type, and adjust timings.

Method 3: Convert from SRT

If you already have an SRT file, converting it to VTT is straightforward because the formats are very similar. The key changes are:

1. Add WEBVTT as the first line of the file.
2. Replace all commas in timestamps with periods (e.g., 00:00:01,500 becomes 00:00:01.500).
3. Optionally remove the sequence numbers (they are not required in VTT).

You can do this with a simple find-and-replace in any text editor. For bulk conversions, many online tools and command-line utilities handle SRT-to-VTT conversion automatically. Or simply use Captain Transcribe, which exports both SRT and VTT from the same transcription — no conversion needed.

What Are the Differences Between VTT and SRT?

VTT and SRT are the two most popular subtitle formats, and they share a similar structure. However, there are important differences that determine which one you should use — see our full SRT vs VTT comparison for an in-depth look. Here is a quick comparison:

The bottom line: VTT is the best choice for web-based video because it is the native format for HTML5 browsers and offers advanced features like styling and positioning. SRT is the safer choice for general compatibility across desktop video editors, media players, and social media platforms. For a deeper comparison, see our full article on SRT vs VTT subtitle formats. You can also learn more about the SRT format in our guide to what is an SRT file.

Where to Use VTT Files

VTT files are supported across a wide range of platforms and technologies, particularly those built for the web:

• HTML5 video — The <track> element in HTML5 is designed specifically for VTT files. Adding subtitles to a web video is as simple as including <track src="subtitles.vtt" kind="subtitles" srclang="en"> inside your <video> tag. Every modern browser supports this natively with no plugins or JavaScript libraries required.
• YouTube — YouTube accepts VTT file uploads for adding captions to your videos. Upload via YouTube Studio under the Subtitles tab, just as you would with an SRT file.
• Vimeo — Vimeo supports VTT uploads for captions and subtitles. VTT is actually Vimeo's recommended subtitle format.
• Web-based video players — Popular JavaScript video players like Video.js, Plyr, and JW Player all use VTT as their primary subtitle format.
• E-learning platforms — Learning management systems (LMS) like Moodle, Canvas, and Coursera use VTT for course video captions. If you are creating educational content, VTT is often the required format.
• Streaming services — Many streaming platforms use VTT or VTT-based formats (like HLS with WebVTT segments) for delivering subtitles to viewers.

How to Open and Edit VTT Files

Because VTT files are plain text, you can open and edit them with any text editor on any operating system:

• Windows — Notepad, Notepad++, or VS Code
• Mac — TextEdit (switch to plain text mode first), Sublime Text, or VS Code
• Linux — gedit, nano, vim, or VS Code
• Online — Any web-based code editor

For more advanced editing with a visual timeline, dedicated subtitle editors like Subtitle Edit, Aegisub, and Jubler can open and save VTT files. These tools let you adjust timing visually alongside the video playback, which is helpful when you need to fine-tune subtitle synchronization.

When editing VTT files manually, always save with UTF-8 encoding and make sure the file extension remains .vtt. Some text editors on Windows default to ANSI encoding, which can corrupt non-English characters.

Common VTT Mistakes to Avoid

Even though the VTT format is straightforward, a few common errors can cause your subtitles to fail silently — the file loads without an error message, but no subtitles appear. Here are the mistakes to watch for:

• Missing WEBVTT header — This is the most common mistake. The very first line of the file must be WEBVTT (optionally followed by a space and description text on the same line). If this header is missing or misspelled, browsers will not recognize the file as valid WebVTT and will ignore it entirely.
• Using commas instead of periods in timestamps — If you are converting from SRT or are used to the SRT format, you might accidentally use commas as the millisecond separator (e.g., 00:00:01,500). VTT requires periods (00:00:01.500). Commas in timestamps will cause parsing errors.
• Wrong file encoding — VTT files must be UTF-8 encoded. If you save with a different encoding (like Windows-1252 or Latin-1), accented characters and non-Latin scripts will display as garbled text or cause the file to fail.
• Missing blank lines between cues — Each cue must be separated by at least one blank line. If you forget the blank line between two cues, the parser may merge them or skip them entirely.
• Incorrect MIME type on your server — When serving VTT files from a web server, the file must be served with the MIME type text/vtt. If your server sends it as text/plain or another type, some browsers will refuse to load it. Most modern web servers handle this correctly, but if your subtitles are not appearing on your website, check the MIME type configuration.
• Overlapping timestamps — While VTT technically allows overlapping cues, they can cause display issues in some players. Keep your timestamps sequential with no overlap for the most reliable playback across all platforms.

Start Creating VTT Files Today

Whether you are adding subtitles to a website, uploading captions to YouTube or Vimeo, or building an e-learning platform, VTT is the modern standard for timed text on the web. Its support for styling, positioning, and metadata makes it more powerful than SRT for web-based use cases, while remaining just as easy to read and edit as a plain text file.

The fastest way to create accurate VTT files is with Captain Transcribe. Upload your video or audio, choose your language and subtitle style, and download a perfectly formatted VTT file in seconds. No manual timing, no format errors — just accurate subtitles ready to use on any web platform. Try it free today.

Key Takeaways

• VTT is the W3C standard for web subtitles — native to all HTML5 browsers via the track element.
• Every VTT file must start with WEBVTT — without this header browsers reject the file silently.
• VTT supports CSS styling and positioning — control font, color, and placement per cue.
• Converting SRT to VTT is straightforward — add the header and replace commas with periods.
• Use VTT for web, SRT for editors — VTT excels online while SRT has universal compatibility.