TThatDeveloperGuySDVOSB. Hand coded.
Glossary · Schema + Structured Data

VideoObject Schema

VideoObject schema is the Schema.org type that declares a page contains video content. Required for video carousel inclusion in Google SERPs, YouTube-style video rich snippets, and AI Overview citation of video sources. Pages with proper VideoObject schema receive approximately 3x more impressions and 2x more clicks than video-content pages without schema in 2026 industry data.

Also called: VideoObject JSON-LD, Video schema · Last updated: May 27, 2026 · By Joseph W. Anady

Why it matters.

VideoObject schema is the most under-utilized impression-expansion lever in 2026. Most sites with videos either embed them inline without schema (Google doesn't know what the video is about) or rely on YouTube to surface the video separately (losing the host-site traffic). Proper VideoObject schema on the host page unlocks video-specific SERP features and AI extraction.

How it works.

VideoObject schema lives in a JSON-LD block on the page hosting the video. Required: @context, @type VideoObject, name, description, thumbnailUrl, uploadDate. Recommended: contentUrl, embedUrl, duration (ISO 8601), interactionStatistic, transcript, hasPart (Clip schema for key moments), publisher, regionsAllowed.

2026 reality check.

Reddit's October 2025 lawsuit dropped Perplexity citations 86 percent almost overnight. YouTube absorbed the gap — YouTube is now the under-radar #2 social citation source for AI search. Sites with VideoObject schema on YouTube-hosted videos benefit twice: from the video carousel SERP feature and from AI engines citing the host page when discussing the video.

Data points

  • Schema.org VideoObject documented at https://schema.org/VideoObject
  • Video schema = 3x impressions, 2x clicks vs no schema (NAV43 2026 research)
  • YouTube absorbed Reddit's lost citation share post-October 2025 lawsuit (techedgeai 2026)
  • thumbnailUrl required ≥1280x720, jpg/png, no embedded play button
  • Clip schema enables Google's Key Moments SERP feature

First-hand insight from ThatDeveloperGuy.

ThatDeveloperGuy is currently expanding video output via YouTube screencasts of technical tutorials. Each video gets VideoObject schema on the host page with full transcript embedded (helps both SEO and accessibility). The Clip subtype with Key Moments has documented citation lift for instructional content. Per 2026 NAV43 research, video schema = 3x impressions, 2x clicks vs no schema.

How TDG approaches it

Every TDG video has full VideoObject schema: name matching video title, description summarizing the content, thumbnailUrl pointing to a high-quality 1280x720+ thumbnail, uploadDate in ISO 8601, duration in ISO 8601, contentUrl for direct file or embedUrl for YouTube, transcript embedded in the page, Clip schema for Key Moments. Publisher @id to TDG Organization.

Common mistakes.

  • Missing thumbnailUrl (required for video rich snippets and carousel inclusion)
  • uploadDate format incorrect (must be ISO 8601 date)
  • duration format incorrect (must be ISO 8601 duration like PT5M30S for 5 min 30 sec)
  • Skipping transcript (transcripts boost SEO + accessibility + AI extraction)
  • Failing to add Clip schema for instructional/long-form videos (Key Moments multiply citation surface)

FAQ.

Do I need VideoObject schema for embedded YouTube videos?

Yes. The schema on your host page tells Google that your page contains the video, even if YouTube hosts the file. Without schema, the YouTube video may rank but not on your domain.

What's Clip schema?

A subtype of CreativeWork that declares Key Moments in a video — start time, end time, name. Enables Google's 'Key Moments' SERP feature that lets users jump to specific timestamps in your video from the SERP.

How do I add a transcript?

Embed the transcript in the page HTML (visible text). Optionally reference via VideoObject.transcript property pointing to a separate transcript URL. Transcripts boost SEO, accessibility, and AI citation.

Does VideoObject affect Core Web Vitals?

Schema itself doesn't, but embedded video does. Lazy-load videos (data-src or facade pattern) to avoid LCP/INP impact while still enabling schema.

Can I have multiple VideoObjects on one page?

Yes — useful for video gallery pages. Each VideoObject is a separate JSON-LD block (or array of objects with appropriate IDs).