WebVTT is a timed-text format. Its header, cue timing and text structure must be valid, and the player must actually load the track. A readable .vtt file alone does not prove that captions are available or enabled for a service item.
Establish scope before editing
This reference applies to an authorised external caption file or a publisher-provided sample. Keep the original untouched and inspect a copy as plain text. Do not upload private media, programme transcripts or account URLs to a converter. Embedded broadcast captions and image-based subtitle tracks use other workflows; changing their filename to .vtt does not convert them.
Read an original two-cue example
A minimal illustrative text is: WEBVTT, then a blank line, then 00:00:01.000 --> 00:00:03.000, then "[Door opens]". After another blank line, 00:00:04.000 --> 00:00:06.500 introduces "Welcome to the demonstration." Keep these as separate lines when creating a local text example. The invented wording describes no actual programme.
The format uses UTF-8 text and timed cues. Check that the start precedes the end and that the arrow is the ordinary cue separator. A word processor may add formatting or substitute characters; a plain-text view is more informative for structure. Styling support can differ between players, so begin with legible unstyled text.
Separate three outcomes
If the player does not list a caption track, investigate whether it supports external captions and how the track is attached. If the track is listed but never appears, verify that it is enabled and that playback reaches a cue’s time. If captions appear consistently too early or late, first confirm that the file matches the exact programme edit. A timing adjustment cannot reliably reconcile a different cut with scenes removed.
- Use the player’s documented subtitle selection or external-track control.
- Test a known cue time on the matching authorised presentation.
- Record whether the failure concerns loading, rendering or timing.
Separate timing from attachment
A compatible player should show the example text only during its cue intervals when correctly attached to a matching timeline. No playback test is claimed here. For a real failure, send the publisher the player edition, track format, selected language and a short description of the structural or timing issue. Request the correct authorised caption edition when the programme and track differ rather than publishing or redistributing a modified transcript.