WebVTT troubleshooting

A caption file ends in .vtt but the player treats it as SRT

Check the file header and timestamp notation before renaming the extension.

Check the file header and timestamp notation before renaming the extension.

Reproduce the condition

The WebVTT sample below is a small synthetic file. It carries no active media source or account data.

1
00:00:02,000 --> 00:00:05,000
Example caption

What the local check found

Reproducible check against the packaged fixture and parser.
Expected signalObserved signal
Missing WEBVTT headerMissing WEBVTT header

What to do next

Use a proper subtitle conversion tool. A renamed SRT file retains its comma notation and may lack a WebVTT header.

What to share if the problem continues

  • The exact parser result and version of the importer or player.
  • A minimal redacted sample with dates, IDs or segment names retained as needed.
  • The output after checking the source export separately from the viewer app.

Sources and further reading