VideoObject Schema Markup
VideoObject markup helps your videos appear in Google Video search, video carousels, and rich results with thumbnails, duration, and upload information.
Google Search Features
- Review snippet Star ratings and a review excerpt for the reviewed item. Local businesses and organizations: only reviews of other businesses, not reviews they collect about themselves.
- Video Video results with a thumbnail, duration, key moments and LIVE badge.
- Learning video — Retired (since September 9, 2025) Google no longer shows this rich result. VideoObject is still a valid schema.org type; the markup does no harm but earns no rich result.
When to Use VideoObject
Properties
| Property | Type | Status | Description |
|---|---|---|---|
| name | Text | required | Video title. |
| description | Text | recommended | Video description. |
| thumbnailUrl | URL | required | Video thumbnail image. |
| uploadDate | Date | required | When the video was uploaded. |
| duration | Duration | recommended | Video length in ISO 8601 format. |
| contentUrl | URL | recommended | Direct URL to the video file. |
| embedUrl | URL | recommended | URL for embedding the video. |
| interactionStatistic | InteractionCounter | optional | View count. |
| publication | BroadcastEvent | optional | Whether the video is live. |
JSON-LD Examples
Tutorial Video
A how-to video with duration and thumbnail.
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "How to Set Up a React Project",
"description": "Step-by-step tutorial on creating a new React application from scratch.",
"thumbnailUrl": "https://example.com/react-tutorial-thumb.jpg",
"uploadDate": "2024-03-10",
"duration": "PT12M30S",
"contentUrl": "https://example.com/videos/react-setup.mp4",
"embedUrl": "https://youtube.com/embed/abc123"
}Common Mistakes
Missing thumbnailUrl — Google requires a thumbnail to show the video rich result.
Using human-readable duration instead of ISO 8601 (PT12M30S, not '12:30').
Complete Guide to VideoObject Schema Markup
VideoObject markup is essential for any page featuring video content. It enables your videos to appear in Google Video search, video carousels in web search, and dedicated video rich results with thumbnails, duration, and upload dates.
Google requires name, thumbnailUrl and uploadDate, and recommends description, duration and contentUrl or embedUrl. Without a thumbnail, Google won't display the video rich result. Duration is strongly recommended as Google displays it on the thumbnail overlay.
Related Types
Check Your VideoObject Markup
The generator doesn't have a VideoObject form yet. Paste your markup into the validator to check its types, properties and values, and what Google needs from it.
Open Validator