# Video Schema + Transcript Audit — why your YouTube embed doesn't rank

YouTube owns video search. But your page can still win the text-on-a-page-with-video layer — if it has VideoObject schema, a crawlable transcript, and captions. Most pages with embedded video have none of the three.

Author: J.A. Watte
Published: April 22, 2026
Source: https://jwatte.com/blog/blog-tool-video-schema-transcript-audit/

---

_Part of the [AEO / GEO / AI-search audit tool stack](/blog/blog-new-aeo-audit-tools-2026/).  See the pillar post for the full catalog of sibling audits and where this one fits in the lineup._

Google shows video thumbnails in the main SERP when:

1. Your page has `VideoObject` JSON-LD with the required properties
2. The thumbnail is large enough (minimum 120×90, recommended 600×338)
3. The video is embedded via an `<iframe>` or `<video>` with discoverable source
4. The video has a transcript the crawler can extract
5. The page itself is about the same topic as the video

Missing any of those drops you out of the video SERP. A page with a YouTube embed and no schema is invisible to this layer — Google ranks the YouTube listing instead of your page.

[The Video Schema + Transcript Audit](/tools/video-schema-transcript-audit/) tests all five conditions in a single pass.

## What it checks

### Video schema presence
- `VideoObject` JSON-LD in the page
- Required: `name`, `description`, `thumbnailUrl`, `uploadDate`
- Recommended: `duration`, `contentUrl` / `embedUrl`, `publisher`, `interactionStatistic`
- For live streams: `BroadcastEvent` nested inside

### Schema quality
- Thumbnail URL is `https://` and resolves
- `duration` in ISO-8601 format (`PT4M13S`)
- `uploadDate` in ISO-8601
- `description` at least 50 chars

### Video element discovery
- Detects embedded `<iframe src>` pointing at youtube.com, vimeo.com, wistia.com, etc.
- Detects `<video>` with `<source>` children
- Flags missing `aria-label` on embeds (accessibility)
- Flags missing `title` attribute

### Transcript presence
- Searches the page for a `<track kind="captions">` on any `<video>`
- Searches for a visible transcript block (heuristics: "Transcript:" heading, long text near video)
- Searches for schema.org `transcript` property

### Caption / accessibility
- Flags videos with no captions
- Flags autoplay (user hostility + accessibility)
- Flags missing poster image

## Why the transcript matters

YouTube auto-generates captions. Google *can* read them — but only inside YouTube. A transcript on your page is the version Google reads for *your page's* topic signal. That text is what ties your page to the video's subject and qualifies you for the video SERP as the page URL, not just the YouTube URL.

A 10-minute video with a visible transcript is also how you:
- Rank for long-tail queries inside the transcript
- Qualify for featured snippets extracted from the transcript text
- Serve accessibility (WCAG 1.2.1 — audio-only / video-only alternatives)

## How to use it

1. Go to [/tools/video-schema-transcript-audit/](/tools/video-schema-transcript-audit/)
2. Paste a URL with an embedded video
3. Tool fetches, parses, and reports
4. Read the score and each check
5. Copy the fix prompt — it includes a valid VideoObject JSON-LD template you can paste into your CMS

## Related reading

- [Schema Test-Case Generator](/tools/schema-test-case-generator/) — valid JSON-LD starter templates
- [Rich Results Eligibility Audit](/tools/rich-results-eligibility-audit/)
- [Featured-Snippet Extractability](/tools/featured-snippet-extractability/)

## Fact-check notes and sources

- **Video structured data requirements:** [Google Search Central — Video](https://developers.google.com/search/docs/appearance/structured-data/video).
- **schema.org VideoObject reference:** [schema.org/VideoObject](https://schema.org/VideoObject).
- **WCAG 1.2.1 Audio-only / Video-only:** [W3C WCAG 2.1 — 1.2.1](https://www.w3.org/WAI/WCAG21/Understanding/audio-only-and-video-only-prerecorded.html).
- **YouTube auto-caption accuracy:** [Google Accessibility Blog — captions](https://blog.google/outreach-initiatives/accessibility/).

_This post is informational, not SEO-consulting or accessibility-consulting advice. Mentions of Google, YouTube, Vimeo, Wistia, and similar products are nominative fair use. No affiliation is implied._


---

Canonical HTML: https://jwatte.com/blog/blog-tool-video-schema-transcript-audit/
RSS: https://jwatte.com/feed.xml
JSON Feed: https://jwatte.com/feed.json
Hero image: https://jwatte.com/images/blog-tool-video-schema-transcript-audit.webp