VideoObject schema describes video content hosted on your own pages: what it shows, how long it runs, and where to find it. It is increasingly relevant as AI systems pull video directly into multimodal answers rather than treating it as a separate kind of search.
VideoObject schema states a video’s title, description, duration, and thumbnail explicitly, giving a model everything it needs to represent the video accurately without watching it. Add one block per page where video is the primary content, using either contentUrl or embedUrl depending on how the video is hosted, and it’s increasingly relevant as AI systems pull video directly into multimodal answers.
- name, description, thumbnailUrl, and uploadDate are the required fields Google checks for video eligibility, a broken thumbnail link is one of the most common reasons markup gets ignored.
- Video hosted on YouTube and just embedded needs it less, since YouTube already provides its own metadata, but it’s still worth adding when the video is central to the page.
- Article and VideoObject schema can coexist on the same page when an article includes a supporting embedded video.
What VideoObject Schema Actually Does
Without it, a search engine or an AI crawler has to guess at what a video actually shows from the surrounding page text, which is unreliable, especially for video hosted directly on your own site rather than a platform that already carries its own metadata. VideoObject states the title, description, duration, and thumbnail explicitly, giving a model everything it needs to represent the video accurately without watching it.
The Code: A Working Example
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "How We Shape Sourdough",
"description": "A short walkthrough of how our bakers shape a sourdough loaf before its final proof.",
"thumbnailUrl": "https://riversidebakery.example/videos/sourdough-shaping-thumb.jpg",
"uploadDate": "2026-05-10",
"duration": "PT2M30S",
"contentUrl": "https://riversidebakery.example/videos/sourdough-shaping.mp4"
}The Fields That Unlock Video Rich Results
name, description, thumbnailUrl, and uploadDate are the required fields Google’s video documentation checks for video eligibility. duration, written in the same format covered in our HowTo schema guide, helps a model or a search result show how long the video runs before someone commits to watching. Include either contentUrl, a direct link to the video file, or embedUrl, a link to a page that plays it, depending on how your video is hosted.
Where to Add It on Your Site
Add one VideoObject block per page where video is the primary content, not a decorative background clip or an autoplay element with no real informational value. If a page includes both an article and an embedded video that supports it, Article and VideoObject schema can coexist on the same page.
How to Validate It
Run the page through Google’s Rich Results Test to confirm the video is eligible for video specific display. Check the raw JSON-LD in Schema.org’s Validator as well, and confirm the thumbnail URL actually resolves to a real image, since a broken thumbnail link is one of the most common reasons video markup gets ignored.
FAQ
Do I need VideoObject schema for videos hosted on YouTube and just embedded on my site?
It is less critical, since YouTube already provides its own metadata to search engines. It is still worth adding if the video plays a central role on the page, since it reinforces the same information in a format your own site controls.
What duration format does schema.org expect?
The same format used elsewhere in structured data: PT followed by a number and a unit, such as PT2M30S for two minutes and thirty seconds.
Can VideoObject schema help a video get pulled into an AI generated answer?
It can. AI systems are increasingly pulling video directly into multimodal answers, and clear, accurate VideoObject metadata is one of the more reliable ways to make sure a model represents your video correctly if it does.
Related Reading
Go deeper on content and instructional schema:
Want to Be the Brand AI Recommends?
Book a call and we’ll map what it takes to get there for your business.