spyc.ai

Free tool

Video Schema Generator

Write VideoObject JSON-LD with title, thumbnail, upload date and duration.

How it works

What is the Video Schema Generator?

The Video Schema Generator is a free tool that writes VideoObject structured data in JSON-LD for a page with a video. Enter the title, description, thumbnail, upload date, length and the file or embed URL, then copy the code. Minutes and seconds are converted to the ISO 8601 duration the markup requires.

How to use the Video Schema Generator

  1. Enter the video's title and a description of what it covers.
  2. Add the thumbnail URL, the upload date and the length.
  3. Add the video file URL, the embed URL, or both.
  4. Copy the code, paste it into the page that shows the video, and validate it.

What is video schema?

Video schema is structured data that describes a video on a page with the schema.org VideoObject type. It gives the title, a description, a thumbnail, the upload date, the duration, and where the video file or player lives.

Google can find videos without it, but the markup removes guesswork about which thumbnail, date and description belong to the video, and it is how a page becomes eligible for video features in Search, the Video tab and Discover.

Which video schema properties are required?

Google requires three: name, thumbnailUrl and uploadDate. It recommends description, duration, and either contentUrl, the address of the video file, or embedUrl, the address of the player.

Give contentUrl when you host the file, because it lets Google fetch the video itself. For a YouTube or Vimeo embed you only have embedUrl, in the form https://www.youtube.com/embed/VIDEO_ID.

Do I need video schema for an embedded YouTube video?

It helps your page, not the YouTube watch page. YouTube's own page will usually be the one Google shows for the video. Adding VideoObject markup to your page makes your page eligible to appear as a video result too, when the video is the main content there.

That last condition matters. Since late 2023 Google shows a video thumbnail only for pages where the video is the main content, not for an article with a clip halfway down.

What are key moments and how do I add them?

Key moments are the chapter links Google shows under a video result. There are two ways to supply them. Add Clip objects to the VideoObject, each with a name, a startOffset in seconds and a url that jumps to that time. Or add a SeekToAction that tells Google your URL pattern for timestamps, and let it pick the moments.

For YouTube videos, timestamps in the video description do the same job. The generator writes the base VideoObject; add clips to it by hand.

How is video duration written?

As an ISO 8601 duration: PT4M30S is four minutes thirty seconds, PT1H2M is an hour and two minutes. Enter minutes and seconds and the generator writes it. The upload date is also ISO 8601; adding a time and time zone is better than the date alone. Validate the block with the Schema Markup Validator.

Questions

What size should the video thumbnail be?
At least 60 by 30 pixels, and larger is better. The URL must be crawlable and point to an image file such as JPG, PNG or WebP.
Can one page have several videos marked up?
Yes, one VideoObject per video. Google will still treat a page as a video page only if a video is its main content.
Does video schema help with AI search?
It gives machines the title, description and date of the video without watching it. A transcript on the page does more, because the words are what an assistant can quote.
Do I need a video sitemap as well?
Not as well, but it helps Google discover videos on large sites. Structured data and a video sitemap can be used together.
Is this schema generator free?
Yes, with a free spyc.ai account. The code is built in your browser as you type, so nothing you enter is sent to a server.

Technical SEO Tools

More in Technical SEO Tools

Opengraph Viewer

Paste a URL and see the card it produces when someone shares it — title, description, image.

View Opengraph

Open Graph Generator

Write the Open Graph tags, preview the card, copy the markup.

Generate Open Graph tags

Robots.txt Checker

Fetch any site's robots.txt and test one URL against it: allowed, or blocked by which rule.

View robots.txt

Ready when you are

Before your next buyer asks AI about you, ask AI about yourself

One check, four engines, about twenty seconds. We show you the answers before we ask for anything.