Video Schema Generator
Create VideoObject structured data (JSON-LD) for any video. Paste a YouTube link to fill fields automatically, then copy the markup into your page.
- Free
- No sign-up
- Works on any website
- Updated September 2026
Settings
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "How to add a video gallery to your website",
"description": "A step-by-step guide to adding a video gallery.",
"uploadDate": "2026-09-01",
"duration": "PT3M30S"
}
</script>Missing required: thumbnailUrl
Get video markup for every video automatically
Video Gallery can add Schema.org video markup for all videos in your gallery — no JSON-LD to write or update when you publish new videos.
- Auto-updates when you publish new videos
- Carousel, grid, masonry or player with playlist
- YouTube, Vimeo, TikTok, Instagram, Twitch and any video link
- No coding — works on any website
How to use the Video Schema generator
- 1Enter video details
Paste a YouTube link to autofill the thumbnail and embed URL, then add a title, description and upload date.
- 2Check required fields
Google requires name, thumbnailUrl and uploadDate. Add a contentUrl or embedUrl too.
- 3Copy and validate
Paste the script into the page’s <head> and test it with Google’s Rich Results Test.
VideoObject fields
| Field | What it does | Status |
|---|---|---|
name | The video title. | Required |
thumbnailUrl | Image shown in search results. | Required |
uploadDate | When the video was published (ISO 8601). | Required |
description | What the video is about. | Recommended |
duration | Length in ISO 8601, e.g. PT3M30S. | Recommended |
contentUrl | Direct link to the video file. | Recommended |
embedUrl | Link to the video player. | Recommended |
How to add the markup to your site
Add the script with an SEO plugin’s schema field or a header-scripts plugin, on the page where the video plays.
Paste it into theme.liquid inside <head> wrapped in a template condition, or into the page’s template.
Go to Settings → Custom Code, add the snippet to Head and apply it to the video page only.
Open the page’s Settings → Advanced → Page Header Code Injection and paste the script.
Open Page settings → Custom code → Inside <head> tag, paste the script and publish.
Paste the script inside <head> of the page where the video is embedded.
Frequently asked questions
What is video schema markup?
It’s structured data using the schema.org VideoObject type that tells search engines a video’s title, thumbnail, upload date, length and where to play it.
Which VideoObject fields are required?
Google requires name, thumbnailUrl and uploadDate. Adding description, duration and a contentUrl or embedUrl is recommended — see Google’s video structured data documentation.
Where do I put the JSON-LD?
Paste it into the <head> of the page where the video actually plays, then validate it with Google’s Rich Results Test.
Does video schema guarantee rich results?
No. It makes the page eligible for video features; Google decides whether to show them.
What format does duration use?
ISO 8601 — three minutes and thirty seconds is PT3M30S. The generator converts mm:ss for you.
Official documentation
More free tools
Related guides
From one video to a gallery people watch
Create a free video gallery in minutes and add it to any website.
Create Widget for Free