VideoObject Schema Markup
VideoObject markup helps your videos appear in Google Video search, video carousels, and rich results with thumbnails, duration, and upload information.
Eligible Rich Results
When to Use VideoObject
Properties
| Property | Type | Status | Description |
|---|---|---|---|
| name | Text | required | Video title. |
| description | Text | required | 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.
The four required properties are name, description, thumbnailUrl, and uploadDate. 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
Ready to Create VideoObject Markup?
Use our free generator to create valid VideoObject JSON-LD markup with a visual form. No coding required.
Open Generator