Skip to content
Schema Generator
Menu

Video schema generator

A video hosted or embedded on the page.

Rich result availableVideoObject · Video

Fields marked with an asterisk are required. Your input stays in this browser.

Required

Without these, Google won't use the markup.

One URL per line, at least 60×30 px.

Recommended by Google

Fill what applies. More complete markup gets richer results.

Minutes and seconds (4:35) or hours too (1:02:10).

The .mp4 or stream itself. Give this, the embed URL, or both.

For YouTube or Vimeo, the embed URL from the share menu.

OptionalExtra detail for other search engines and tools.Show 3 fields

Only if the video will be taken down.

Publisher

Guide

What Google does with VideoObject markup

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 it

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

Fields Google looks for

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

Example output

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"
}

Common questions

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.