Skip to content
Schema Generator
Menu

Video schema generator (JSON-LD)

A video hosted or embedded on the page.

Rich result available: Video. Schema.org type VideoObject.

1 of 7

VideoObject rich results in Google

Helps Google find the video, show a thumbnail and duration, and link to key moments. Google requires a name, a thumbnail, and an upload date. The video must be the main content of the page to get a video result.

Google's video documentation

When to use Video schema

Add to pages where a video is the primary media. Embed pages, watch pages, and tutorial articles with a lead video are common cases.

VideoObject properties Google requires and recommends

PropertyStatusIn the form
nameRequiredTitle
thumbnailUrlRequiredThumbnail URLs
uploadDateRequiredUploaded
descriptionRecommendedDescription
durationRecommendedLength
contentUrlRecommendedVideo file URL
embedUrlRecommendedPlayer URL

Video JSON-LD example

This is what the builder produces from the example data. Paste it into the page's HTML, in the <head> or the body.

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Replacing a bike chain in 5 minutes",
  "description": "The tools you need and the five steps to swap a worn chain.",
  "thumbnailUrl": [
    "https://example.com/images/chain-thumb.jpg"
  ],
  "uploadDate": "2026-04-02T10:00",
  "duration": "PT4M35S",
  "embedUrl": "https://www.youtube.com/embed/abc123"
}

Video schema FAQ

Must contentUrl and embedUrl both be present?
Provide at least one playback path Google can fetch. Many publishers supply embedUrl for hosted players.
Does VideoObject guarantee video carousels?
No. Eligibility depends on page quality, video accessibility, and Google's policies for the query.