What is VideoObject schema?

VideoObject is a schema.org type that describes a video file or embedded video. Adding JSON-LD VideoObject markup to your page lets Google understand your video content and makes it eligible for video-enhanced rich results in Google Search and Discover.

Which fields are required?

Google requires name, description, thumbnailUrl, and uploadDate for VideoObject rich results. contentUrl or embedUrl must also be present so Google can access the video. All other fields improve signal quality but are optional.

What is ISO 8601 duration format?

ISO 8601 duration is written as PT#H#M#S. For example a 1-hour 30-minute 45-second video is PT1H30M45S. A 90-second video is PT1M30S. The H/M/S helper fields in this tool generate the correct string automatically.

Should I use contentUrl or embedUrl?

Use contentUrl when you host the video file directly (e.g. an .mp4 on your server). Use embedUrl for YouTube or Vimeo embeds. You can include both. Google prefers at least one so it can crawl or preview the video.

Does adding video schema guarantee rich results?

Valid markup makes your page eligible, but Google decides whether to show rich results based on content quality, authority, and other signals. Always validate with Google's Rich Results Test after deployment.

Is my data sent to any server?

No. All processing happens entirely in your browser. Nothing is sent to any external server.

Video Schema Generator

Name: Video Schema Generator
Availability: InStock
Author: Nham Vu

Fill in your video details and get valid JSON-LD VideoObject structured data ready to paste into your page head.

Video Details

Video Name / Title *

Description *

Upload Date *

Thumbnail URL *

Content URL (direct video file)

Embed URL (YouTube / Vimeo)

Duration (auto-generates ISO 8601)

Hours

Minutes

Seconds

Not set

Video Quality

Publisher Name

Publisher Logo URL

* Required for Google video rich result eligibility.

JSON-LD Output

Paste this code inside the <head> tag of your HTML page. Validate with Google's Rich Results Test after deployment.

Video Preview

Fill in the fields on the left to see a preview.

Copied!

Summary

Fill in your video details and get valid JSON-LD VideoObject structured data ready to paste into your page head.

How it works

Enter the video name, description, upload date, and thumbnail URL (required).
Add a content URL (direct video file) and/or embed URL (YouTube/Vimeo embed link).
Use the H/M/S fields to build the ISO 8601 duration — the PT#H#M#S string is generated automatically.
Optionally select video quality and add publisher name and logo URL.
Copy the generated JSON-LD and paste it inside your page's <head> tag.
Validate the markup with Google's Rich Results Test.

Use cases

Add VideoObject schema to YouTube embeds on blog posts to qualify for video rich results.
Mark up tutorial or how-to videos to improve Google Search appearance.
Generate video structured data for CMS pages that lack a schema plugin.
Create VideoObject markup for product demonstration or promotional videos.
Quickly prototype schema markup while developing a video-heavy site.
Audit and regenerate correct video schema for pages with broken or missing markup.

Frequently Asked Questions

Last updated: 2026-06-10 · Reviewed by Nham Vu