Video Schema Generator - Free JSON-LD Creator

Video Schema Generator

Generate VideoObject JSON-LD schema markup to help your videos appear as rich results in Google Search.

A video schema generator builds VideoObject JSON-LD for the pages where you embed videos. Enter the title, upload date, description, thumbnail, video URLs, duration and publisher, click Generate Schema, and copy a ready-to-paste script tag. It is made for site owners, SEOs and bloggers who want search engines to understand their videos.

What Is Video Schema Markup?

Video schema markup is structured data, written in JSON-LD, that describes a video on a web page using the schema.org VideoObject type. It gives search engines clean facts such as the title, thumbnail, upload date, duration and the location of the file or player, so they do not have to guess from the surrounding page text.

Google's Search Central documentation treats video structured data as a way to help Google find, understand and display your videos in Search. Markup makes a page eligible for enhanced video results. It never guarantees them.

You will also see this called video object schema or VideoObject markup. They all mean the same thing: one block of JSON-LD per video, placed on the page where that video appears.

How to Use the Video Schema Generator

You can build a complete VideoObject block in about two minutes by filling the fields from top to bottom and copying the result.

  1. Type the title in Video Name / Title. This is the only field the generator forces you to fill. If it is empty, you will be asked to enter a video title.
  2. Choose the Upload Date with the date picker. Use the day the video was first published.
  3. Add a Description that matches what viewers actually see and hear, then paste a public image link into Thumbnail URL.
  4. Fill in Content URL (direct video file) if you host a file such as an MP4, and Embed URL if you use a player such as a YouTube embed link. Add both when you have both.
  5. Enter the Duration in ISO 8601 format, for example PT5M30S. Optionally add a Publisher Name and a Publisher Logo URL. The logo is only included when a publisher name is present.
  6. Click Generate Schema, then click Copy. You will see "Schema copied!" and can paste the script tag into the head of your page.

If you edit any field after generating, the result clears so you never copy outdated code. Just click Generate Schema again.

Worked Example: A Sourdough Tutorial Video

Suppose you publish a 5 minute 30 second sourdough tutorial on your bakery blog and embed it from YouTube. Here is what you would enter and what you would get.

  • Video Name / Title: How to bake sourdough bread
  • Upload Date: 2025-03-14
  • Description: A step-by-step guide to mixing, folding, proofing and baking a sourdough loaf.
  • Thumbnail URL: https://example.com/thumb.jpg
  • Embed URL: https://www.youtube.com/embed/xxx
  • Duration: PT5M30S (5 minutes 30 seconds)
  • Publisher Name: Crumb Bakery, with a logo URL

After you click Generate Schema, the output is a script tag of type application/ld+json. It holds a VideoObject with the name, description, thumbnailUrl, uploadDate, embedUrl and duration properties. The publisher is nested as an Organization, and its logo is nested as an ImageObject. Because you left Content URL blank, no contentUrl line appears, which is correct for a video hosted only on a third-party player.

Note that the date comes out as a plain date, 2025-03-14, without a time or time zone. That is accepted, but you can add a time and offset by hand if you want full precision.

Which Video Schema Fields Matter Most?

Google's guidance lists name, thumbnailUrl and uploadDate as required for video rich results, and treats the rest as recommended. The generator only insists on a title, so you must remember the other two yourself.

FieldStatus in Google guidanceExample
Video Name / TitleRequiredHow to bake sourdough bread
Thumbnail URLRequiredCrawlable image file
Upload DateRequired2025-03-14
DescriptionRecommendedOne or two plain sentences
Content URLRecommendedDirect MP4 file
Embed URLRecommendedYouTube embed link
DurationRecommendedPT5M30S
PublisherOptionalBrand name and logo

How Do You Read and Act on the Generated Schema?

A good result is a single script block where every property you filled appears with the value you expect, and every URL starts with http or https.

What a good result looks like

You should see the name, thumbnailUrl and uploadDate lines at minimum, plus contentUrl or embedUrl so Google can locate the video. The duration should follow the pattern PT followed by hours (H), minutes (M) and seconds (S).

What a poor result looks like

If the output has no thumbnailUrl or uploadDate, go back and fill those fields before pasting. A schema with only a name and description tells search engines very little. If the publisher block is missing, you left Publisher Name empty.

Fixing input errors

  • URL error: every link must be absolute, such as https://example.com/video.mp4. Relative paths like /video.mp4 are rejected.
  • Duration error: write the length as PT plus units. 45 seconds is PT45S, 12 minutes is PT12M, and 1 hour 20 minutes is PT1H20M. Writing 5:30 will not work.
  • Date error: pick a real date with the date picker rather than typing free text.

Once the code is on your page, run it through a schema markup validator to confirm the syntax and key properties are intact.

Who Should Use a Video Schema Generator?

Anyone who publishes a video on a page that they want found in search can benefit, especially when writing JSON-LD by hand feels error-prone.

  • Bloggers who embed a YouTube video inside a post and want the page to carry video details. Pair it with an article schema generator for the post itself.
  • Tutorial publishers with video steps. A HowTo schema generator covers the written steps alongside the video markup.
  • Store owners with product demo or unboxing clips on product pages.
  • Agencies and in-house SEOs who need consistent markup across many landing pages without opening a code editor.
  • Course and webinar sites that host recordings and want clear duration and upload data.

Best Practices, Common Mistakes and Troubleshooting

Accurate, visible and consistent markup works better than long markup, so follow these habits.

  • Mark up only videos that appear on the page. The video should be genuinely embedded or playable where the schema sits.
  • Use a thumbnail Google can fetch. If the image is behind a login or blocked from crawling, it cannot be used.
  • Match the description to the video. Do not paste a keyword-stuffed summary that viewers would not recognize.
  • Use the embed link, not the watch link. For YouTube, an address that contains /embed/ belongs in Embed URL.
  • Generate one block per video. If a page has three videos, create three separate script tags instead of squeezing them into one.
  • Keep the duration in sync. If you re-edit and the video becomes 7 minutes long, update the schema to PT7M.
  • Avoid duplicates. Remove old VideoObject code from the page, or from a plugin, before adding new markup.

If the code looks right but no rich result appears, wait for the page to be recrawled and check that the video is actually indexable. Eligibility depends on Google's own judgment of the page and video.

Limitations and Accuracy Notes

The generator produces the properties listed in its form and nothing more, so it is a starting point rather than a full video SEO setup.

It does not add optional properties such as an expiry date, clip or chapter markup, view counts or regional restrictions. If you need them, add them to the output by hand. It also does not check that your URLs load, that the thumbnail exists or that the video is indexed. And no markup can promise a rich result: Google decides what to show.

For other page types, the schema markup generator and the wider On-Page SEO and Meta Tags tools cover more structured data and tags you can use alongside video markup.

Fill in the form above, click Generate Schema and paste the copied JSON-LD into your page. Then validate it, so your video has the best chance of being understood and shown in search.

Frequently Asked Questions

What is video schema markup?
Video schema markup is JSON-LD structured data that uses the schema.org VideoObject type to describe a video. It lists facts such as the title, thumbnail, upload date, duration and video URLs, helping search engines understand the video on your page and consider it for enhanced video results.
Where do I paste the code from the video schema generator?
Paste the copied script tag into the head of the page that contains the video. After clicking Generate Schema and Copy, add it once per video, then check it with a schema validator before publishing.
What format should the video duration use?
Duration must use ISO 8601 format, which starts with PT. For example, 45 seconds is PT45S, 5 minutes 30 seconds is PT5M30S, and 1 hour 20 minutes is PT1H20M. A value like 5:30 will be rejected.
Can I use this generator for a YouTube video?
Yes. Put the YouTube embed link, which contains /embed/, into the Embed URL field. Leave Content URL empty unless you host the actual video file yourself, then add the title, upload date and thumbnail as usual.
Which fields do I need for video rich results?
Google's guidance lists name, thumbnail URL and upload date as required. The generator only forces a title, so also fill Thumbnail URL and Upload Date. Description, Content URL, Embed URL and Duration are recommended extras that give search engines more detail.
Is the video schema generator free, and does it guarantee rich results?
The generator is free and needs no sign-in. It cannot guarantee rich results, because Google decides what to display. Accurate, complete VideoObject markup on a page with a crawlable video and thumbnail makes the page eligible.
Recommended

Explore VPN options

A VPN changes your network exit. It does not guarantee anonymity.

Hide Your IP Encryption Network coverage
Protect My IP Now