VideoObject structured data with transcript on every video page
Tell AI systems that your page hosts video, and hand them the transcript text.
What this signal tests
We look for VideoObject markup in your page's structured data. This is a labelled block of JSON that names the video, points to a thumbnail, gives an upload date, and links to the video file or embed. Bonus credit when a transcript field carries the full spoken text.
Why it matters for your visibility in AI
Most AI crawlers do not watch videos. They read the text around them. Without VideoObject markup, an assistant summarising your page may not realise a video exists at all, or may guess what it contains from the surrounding paragraph and get the details wrong. If you embed a transcript, the same crawler can ingest the full spoken content as text. That means an AI answer engine can quote your interview, reference the demo step you showed at 2:14, or cite your explainer when a user asks about the topic. Competitors who publish transcripts get cited; ones who only ship an opaque video player do not.
Pass criteria at a glance
| Criterion | Passes when |
|---|---|
| 100% of video-bearing pages have VideoObject with required fields; >=30% include transcript. |
How we test it
Our scanner fetches the page and parses every JSON-LD block. It looks for one with @type set to VideoObject and checks that it carries a name, a thumbnail URL, an upload date in ISO 8601 format, and either a contentUrl or an embedUrl. If a transcript field is present and contains at least 200 characters, the page earns the bonus credit.
Show technical detection method
@type VideoObject with required fields; score whether transcript is populated (>=200 chars).
If your site fails: how to fix it
- Add a JSON-LD VideoObject block to every page that hosts or embeds a video. Include name, description, thumbnailUrl, uploadDate (ISO 8601 with timezone), and either contentUrl (direct video file) or embedUrl (player URL).
- Add a duration property using ISO 8601 format like PT5M32S for 5 minutes 32 seconds. AI systems use duration to decide whether a clip is worth ingesting in full.
- Generate a transcript using Whisper, Otter, Descript, or your video host's built-in captions, then paste the full text into the transcript field of the VideoObject. Aim for 200+ characters minimum.
- If you use YouTube, Vimeo, or Wistia, check whether their embed helper already injects VideoObject markup. Many do, but the transcript field is rarely populated automatically.
- Validate your markup with Google's Rich Results Test before deploying. A typo in @type or a missing required field invalidates the whole block.
Quick facts
| Maturity | ESTABLISHED |
|---|---|
| Weight | high |
| Category | Multimodal |
Primary sources
Related signals
Frequently asked questions
Do I need VideoObject markup if my video is hosted on YouTube and just embedded on my page?
Yes. The YouTube iframe carries metadata for YouTube's own search, but your page still needs its own VideoObject so AI crawlers reading your HTML know a video is present. Otherwise your page looks textually identical to one without the embed.
What counts as a good transcript? Auto-generated captions or human-edited text?
Both help, but human-edited transcripts are noticeably better. Auto-captions misspell proper nouns, brand names, and technical terms, which directly degrades how well an AI can cite your content accurately. Spend a few minutes cleaning up names and key phrases.
Can I use VideoObject without exposing a direct video file URL?
Yes. The schema accepts either contentUrl (direct file) or embedUrl (player URL like youtube.com/embed/...). embedUrl is fine for hosted video. AI crawlers that cannot stream the file will still pick up name, description, thumbnail, and transcript.
Will this help my video show up in Google video search?
It is one of the inputs. Google requires VideoObject for video rich results, and AI search interfaces that piggyback on the same index inherit that benefit. Without it your video is effectively text-only to most retrieval pipelines.
Run your own scan
Run a free scan and see how your site grades across all 155 AI-readiness signals.