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

Part of the AEO / GEO / AI-search audit tool stack. 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 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/
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 — valid JSON-LD starter templates
• Rich Results Eligibility Audit
• Featured-Snippet Extractability

Fact-check notes and sources

• Video structured data requirements: Google Search Central — Video.
• schema.org VideoObject reference: schema.org/VideoObject.
• WCAG 1.2.1 Audio-only / Video-only: W3C WCAG 2.1 — 1.2.1.
• YouTube auto-caption accuracy: Google Accessibility Blog — captions.

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.