TranskribatorTranskribator
WebVTT from a transcript: file structure and subtitle checks
Subtitle formats

WebVTT from a transcript: file structure and subtitle checks

How to build a WebVTT file from a transcript: the WEBVTT header, timestamps, cues, timing checks and testing in a player. Includes an example and checklist.

The Transkribator team5-minute read
SOURCEWEBVTT SUBTITLESWEBVTT and a blank lineCue start → endShort cue textTest in the target playerFROM WORDS TO RESULTS
Working with a real recordingIllustrated training exampleTemplate to copy
Subtitle formats

VTT turns a transcript into timed subtitles

A transcript preserves the whole conversation. Subtitles present short pieces of it at the right moments. Begin by dividing the text into cues, syncing them and checking how they read, instead of simply renaming the file. WebVTT is a format for time-aligned text tracks in web video.

A platform may add restrictions around encoding, line length, positioning or file names. Check the requirements where you will upload the file. This guide covers the basic structure and editorial review. Compatibility depends on the target system.

Workflow

Build the file and check it against the video

  1. Prepare a verified transcript

    Correct names, numbers and terminology against the recording. Remove words only under the agreed editorial rules. Subtitles can be verbatim or condensed, but changes to meaning or attribution must not be hidden.

  2. Split the text into short cues

    Set a start and end time for every cue. Avoid unnecessary overlaps, avoid leaving cues on screen after their line ends and do not fit a long paragraph onto one screen. Break the text at a natural point in its meaning.

  3. Write the WebVTT structure

    Put WEBVTT on the first line, then leave a blank line. For every cue use a dot before milliseconds and a timing arrow made of two hyphens and a greater-than sign. Put the cue text below the timing line and follow it with a blank line.

  4. Check in the intended player

    Open the video with the file and watch the beginning, middle, end and areas with fast dialogue. Check for lag, cues that disappear early, text covering important visuals and awkward line breaks. Record problems by timecode rather than noting “somewhere in the second half.”

Worked example

Worked example: short subtitle cues

This is a fictional training example. The names, circumstances and outcomes are included solely to explain the method.

Excerpt from a training recording · 12:40
First open the recording. Then use the timecode to find the line and check the text against the audio.

The sample VTT can use two cues: opening the recording and checking the line by timecode. Leave a blank line between them. You can omit hours in a short clip as long as minutes, seconds and milliseconds are formatted consistently.

Example cue: 00:00:02.000 --> 00:00:04.600, followed by the line “First open the recording.” These are illustrative timings. Find the actual boundaries by watching the source video.

WEBVTT and ablank lineHeaderCue start → endSynchronisationText for ashort cueReadabilityCheck in thetarget playerChecks
A usable VTT file combines correct structure and timing with a check against the actual video.
ChecksWhat to look forIf something is wrong
HeaderWEBVTT on the first lineFix the beginning of the file
TimestampsMove forward and match the speechListen to the section again
CueReadable within its display timeSplit or shorten it
PlayerThe track loads and is readableCheck platform requirements
Ready-to-use template

VTT verification sheet

Use it before delivering the file. It distinguishes valid syntax from viewing quality.

Template for your workSelect and copy
File and version:
Video and duration:
Platform / player:
Encoding:
WEBVTT on the first line: yes / no
First cue:
Last cue:
Timing overlaps:
Cues that are too long:
Names and numbers checked:
Sections to rewatch:
Upload result:
Check the result

Check the file beyond its extension

  • The file begins with WEBVTT and is saved as text.
  • All timing intervals were checked against the video.
  • Cues preserve conditions and negatives.
  • The finished track was watched where it will be published.
TranscriptVerified source textCueDisplay starts and endsWebVTTFile structure and cuesPlayerWatch the result
A subtitle check ends by watching the captions with the video.
Frequently asked questions

A closer look

How is VTT different from SRT?

The formats differ in their headers, timestamp syntax and supported features. Convert the file structure and test the import when changing formats.

Do cues need numbers?

A cue identifier is optional in basic WebVTT. Follow the target system’s documentation if it requires a particular form.

Keep working with the recording