TECHNICAL SEO · SEO GLOSSARY

Video Schema

VideoObject structured data (JSON-LD) that marks up a video on a web page to make it eligible for Google\'s video rich results — including video carousels in web search, video clips in Google Discover, and timestamped chapter navigation in search results.

Definition

Video schema refers to VideoObject JSON-LD structured data added to a web page that contains or embeds a video, providing Google with machine-readable metadata about the video content. Google uses VideoObject schema to generate video rich results in web search. Required VideoObject properties for rich result eligibility: (1) `name` — the video title. (2) `description` — video description matching the content. (3) `thumbnailUrl` — URL to a thumbnail image (minimum 30×30px; Google recommends 1280×720px for best display). (4) `uploadDate` — ISO 8601 date when the video was first published. Recommended additional properties that expand rich result features: `duration` (ISO 8601 duration: PT12M30S for 12 minutes 30 seconds), `contentUrl` (direct URL to the video file), `embedUrl` (embed URL, e.g., YouTube embed URL), `expires` (if the video is time-limited), `hasPart` (VideoObject array for chapter timestamps — enables chapter navigation in rich results), and `interactionStatistic` (view count). For YouTube-hosted videos embedded on a web page: use `contentUrl: "https://www.youtube.com/watch?v=[ID]"` and `embedUrl: "https://www.youtube.com/embed/[ID]"`. The VideoObject schema must be present in the initial server-rendered HTML for Google to associate it with the page — JavaScript-injected schema may be missed during rendering.

Why it matters for SEO

Video rich results — the video carousel that appears in Google Search for video-intent queries — are awarded to pages with valid VideoObject schema. Without VideoObject schema, a page with embedded video is less likely to appear in the video carousel and won\'t have chapter navigation in results. For publishers who produce video content alongside written content, VideoObject schema is the technical prerequisite for capturing the video SERP real estate that text-only schema can\'t access.

How DeepSEOAnalysis checks this

DeepSEOAnalysis validates VideoObject schema on audited pages: checks for required property presence (name, description, thumbnailUrl, uploadDate), validates ISO 8601 duration format, checks that thumbnailUrl is accessible and at a recommended resolution, verifies contentUrl and embedUrl accessibility, and checks that the schema is present in the initial HTML response rather than JavaScript-injected.

GLOSSARY

See how your site scores on Video Schema.

The free DeepSEOAnalysis audit checks video schema and 100+ other signals. Full report, no signup.

Run a free audit →