How to Generate VideoObject Schema (Step by Step)
To generate VideoObject schema, enter your video's name, description, thumbnail URL, upload date and duration into the ByteTools Video Schema Generator, then copy the JSON-LD it produces into your page's HTML. The tool builds a valid VideoObject block automatically, including the fiddly ISO 8601 duration string, so Google can index your video and show it with a rich thumbnail in Search.
This guide walks through the whole process from a blank form to a live script block. It takes only a couple of minutes and requires no coding knowledge, no plugin and no account.
What VideoObject schema is and why you need it
VideoObject is a Schema.org type that describes a video in a structured, machine-readable way. When you add it to a page that embeds or hosts a video, you give search engines the exact title, thumbnail, publish date and length instead of forcing them to guess. That accuracy is what makes your page eligible for video rich results, a thumbnail badge in the main search listing, and a place in Google's dedicated Video tab.
Without markup, a search engine may not recognise that a video exists on the page at all. With it, you unlock features such as video previews and, when the data supports it, key moments that let searchers jump to a section.
Step by step: build your video markup
- Enter the video name and description. Use the real on-page title and a concise, honest summary of what the clip shows.
- Add an absolute thumbnail URL. Point to a crawlable, high-resolution image, for example
https://example.com/thumb.jpg. Relative paths will not work. - Pick the upload date. The date picker outputs the correct ISO 8601 date automatically.
- Set the duration. Type the minutes and seconds; the generator converts them to the required format, so 3 minutes 30 seconds becomes
PT3M30S. - Add the content URL and/or embed URL. The content URL is the raw video file; the embed URL is a playable iframe source such as a YouTube embed link.
- Copy the generated JSON-LD. Paste the full
<script type="application/ld+json">block into your page's HTML, ideally in the<head>or near the video.
Fields you leave blank are omitted automatically, so you never ship empty properties that could trip validation.
Required vs recommended fields at a glance
| Field | Status | Notes |
|---|---|---|
| name | Required | The video title. |
| description | Required | Short, accurate summary. |
| thumbnailUrl | Required | Absolute, crawlable, high quality. |
| uploadDate | Required | ISO 8601 date from the picker. |
| duration | Recommended | ISO 8601, e.g. PT3M30S. |
| contentUrl / embedUrl | Recommended | Helps Google fetch and play the video. |
Why doing it in the browser matters
The generator runs entirely in your browser. Nothing you type is uploaded to a server, so unpublished titles, private URLs and internal thumbnails stay on your own device. Because it is client-side, it also works offline once the page has loaded, which is handy when you are drafting markup on the move.
Try the Video Schema Generator — free and 100% in your browser.
FAQ
Where should the JSON-LD go on my page?
Place the script block anywhere in the HTML, though the <head> or a spot near the video are common choices. JSON-LD does not need to sit inside the video element; Google reads it wherever it appears in the document.
Can I add schema for more than one video on a page?
Yes. Generate a separate VideoObject block for each video and include all of them. Each should describe its own clip with its own thumbnail, duration and URLs so search engines can tell them apart.
How do I check the markup is valid after pasting it?
Run the live page through Google's Rich Results Test or the Schema Markup Validator. They flag missing required fields and formatting errors, which is a good final step before you rely on the markup.
Does the tool store the videos I create schema for?
No. It only formats the text you enter into a JSON-LD block in your browser. There is no database, no upload and no account, so nothing you type is retained after you close the tab.
Related free tools
- JSON-LD Generator — build structured data for many other Schema.org types.
- Article Schema Generator — mark up blog posts and news articles.
- HowTo Schema Generator — add step-by-step markup for tutorials.
- Recipe Schema Generator — create Recipe JSON-LD for cooking pages.
Built by ByteVancer
ByteTools is a free product of ByteVancer, a software and web development studio building web apps, SaaS platforms and custom software. If you need more than a free tool — a bespoke build, an integration or a full product — explore what ByteVancer can create for your team.
Recommended reading
Video Schema Best Practices and Common Mistakes
Avoid the errors that keep VideoObject markup out of Google. Pro tips on thumbnails, duration formatting, upload dates and validation.
Video Schema Use Cases: Real Examples and Workflows
See how creators, marketers and developers use VideoObject schema — from product demos to tutorials — with worked examples and workflows.
Recipe Schema Tips and Common Mistakes to Avoid
Pro tips, best practices and the mistakes that break recipe rich results — from fake ratings to bad ISO 8601 durations and mismatched on-page content.
How to Add Recipe Schema (JSON-LD) to Your Food Blog
A step-by-step guide to generating valid Recipe JSON-LD markup so your dishes qualify for Google recipe rich results — free and private in your browser.