WebVTT Subtitle
Subtitles & CaptionsVTT is WebVTT timed text used for web subtitles/captions. It includes a WEBVTT header and its own timestamp syntax; renaming SRT is not sufficient. Manage it separately from the video.
- What it is used for
- Web subtitles and captions
- What the file contains
- Text
All sections, questions and sources
Content reviewed: · Editor:Kai
Opening steps
Choose your environment or purpose to see its steps.
Menu labels and support vary by app, OS and version. Preserve the original before making changes.
Troubleshooting by symptom
- Web loading fails: check URL, access, text/vtt delivery and applicable cross-origin settings.
- Invalid cues: inspect the header, timestamps, blank lines and cue boundaries.
- Different appearance: test positioning/style support in the actual rendering environment.
- Renamed SRT fails: convert the header and timestamp syntax.
- Loaded but invisible: inspect track selection and cue times.
- Cross-origin load fails: inspect access/CORS requirements.
VTT → SRT
- Use a subtitle exporter to transfer cue text/times, not just rename.
- Review discarded WebVTT-specific settings/notes and test synchronization.
- Validate cue times and destination rendering as well as the header.
SRT may not retain positioning, styling or metadata.
Check loading, selection and cues in order
Inspect resource loading, MIME type, track activation and valid cue timing.
Cross-origin delivery also requires suitable server access settings.
Source for these steps:W3C · WebVTT: The Web Video Text Tracks Format / VideoLAN · Subtitles — VLC desktop user documentation / Aegisub Project · Exporting
Check which presentation features survive
Other formats may not reproduce WebVTT placement/styles; inspect important cues in the destination.
Retain source VTT and video for text/timing comparison.
Source for these steps:W3C · WebVTT: The Web Video Text Tracks Format / VideoLAN · Subtitles — VLC desktop user documentation / Aegisub Project · Exporting
Related-format differences
| Format | Main role | What to check |
|---|---|---|
| VTT | Web timed text | WEBVTT/UTF-8 |
| SRT | Basic captions | Presentation differences |
| ASS | Rich subtitle styling | Placement/fonts |
Handling and security
Review caption URL/content visibility; avoid exposing confidential conversations in public directories.
Questions and answers
Does it need a WEBVTT header?
The format has defined syntax including its header.
Can I reuse SRT timestamps unchanged?
Convert syntax differences such as fractional separators.
Must it use the video’s server?
Separate delivery can work with suitable access/cross-origin settings.
Is VTT only for subtitles?
WebVTT supports other timed-text uses; inspect the intended track kind.
Is replacing commas with dots sufficient?
Headers, cue structure and settings can differ; use supported export.
Format facts: name, steward and MIME type
- Formal name
- Web Video Text Tracks (WebVTT)
- Steward / specification
- W3C
- MIME type
- text/vtt
Primary and official sources
- StandardWebVTT: The Web Video Text Tracks Format
Specification for timed text and cue settings.
W3C · Link checked: - Official documentationSubtitles — VLC desktop user documentation
Load subtitles and select a subtitle track.
VideoLAN · Link checked: - Project documentationExporting
Reference for subtitle export controls.
Aegisub Project · Link checked: