What is a VTT transcript for podcasts?

What is a VTT transcript for a podcast? It is a UTF-8 text file that pairs transcript text with start and end timestamps. Supporting podcast apps can use those timed cues to highlight words or move playback to the relevant part of an episode.

What is a VTT transcript file made of?

VTT stands for WebVTT, or Web Video Text Tracks. Although its name refers to video, the W3C WebVTT specification defines a time-aligned text format that can accompany audio or video.

A basic transcript file starts with the WEBVTT signature. Each cue then contains a timing line followed by its text:

WEBVTT

00:00:02.000 --> 00:00:05.000
Welcome to the show.

00:00:05.500 --> 00:00:09.000
Today we are talking about feed metadata.

The W3C specification requires UTF-8 encoding and the text/vtt MIME type. It also requires a cue's end time to be later than its start time, with cues ordered by start time. Cues may overlap, but overlapping dialogue should reflect the audio rather than repair careless timestamps.

How VTT reaches podcast apps

The Podcast Namespace <podcast:transcript> element links an episode item to a transcript or captions file. Its transcript specification requires two attributes: the file URL and its MIME type. A VTT link uses type="text/vtt".

<podcast:transcript
  url="https://example.com/episode/transcript.vtt"
  type="text/vtt"
/>

The tag can also include a language. If the language is omitted, the specification says the file is assumed to use the feed language. Multiple transcript tags may appear for different formats.

This tag belongs inside an episode item, not at the channel level. Our podcast RSS feed glossary explains the channel and item structure around it.

Apple and Spotify handle VTT differently

Apple says it can automatically create transcripts after publication. Creators who provide their own transcripts can link them through the RSS transcript tag when their host supports it. Apple's transcript guidance also says subscriber episodes can receive VTT or SRT uploads in Apple Podcasts Connect.

Apple requires creator-provided transcripts to use the correct file type, include all episode segments, and avoid spelling and punctuation errors. A VTT file can identify speakers for display when each speaker changes.

Spotify's transcript management documentation describes a separate workflow for eligible creators. They can download a transcript as VTT, edit it on their device, and upload the revised file. Spotify accepts VTT or SRT and says timestamps are needed for synchronized playback. Transcript access is not available to every creator.

These platform workflows do not guarantee that one upload updates the other. Check each destination after a change. The broader podcast transcripts and SEO guide covers the editorial and web-publishing work beyond file format.

A practical VTT acceptance test

Check the file before attaching it to an RSS feed or uploading it to a platform:

1. Open it in a plain-text editor and confirm that the first line begins with WEBVTT.
2. Confirm that the file is saved as UTF-8 and served as text/vtt.
3. Inspect cue times for the correct arrow syntax, increasing end times, and the right spoken passage.
4. Check names, numbers, punctuation, and speaker changes against the audio.
5. Fetch the public file URL without a login or expiring session.
6. Validate the RSS, then inspect the episode in every app you expect to display the transcript.

Separate the checks. A parser can confirm the header, cue structure, and timing format, but it cannot tell whether a person's name is misspelled, a sentence appears during the wrong part of the recording, or the transcript omits a spoken segment. Now listen. Repeat the check from the public URL, because the local file and the served file may differ even when both carry the same filename.

Test early, middle, and late cues. A file can parse correctly while drifting away from the audio after an edit. If audio was replaced or dynamically inserted, compare the live playback path with the version used to produce the transcript.

VTT, SRT, and plain text serve different jobs

VTT and SRT both carry timestamps, though their syntax and supported features differ. Plain text can be easy to read and publish on a web page, but it does not provide synchronized cue timing by itself. The best choice depends on the destination's current rules.

Keep a readable transcript page even when an app receives VTT. The podcast SEO guide explains how an episode page and its crawlable text fit together. The VTT file handles timed playback; the page can supply headings, links, context, and a stable reading experience.

Start with Podder Analytics to track episode delivery while you verify transcript presentation in each listening app.