YouTube Video Schema Markup: How to Get Rich Results in Google Search
If you are embedding YouTube videos on your website and not adding video schema markup, you are leaving one of the most powerful SEO advantages completely on the table. Video rich results — those enhanced search listings with thumbnails, duration badges, and playable previews — can dramatically increase your click-through rate from Google Search. And the key to unlocking them is structured data.
As a YouTube Certified Expert who has spent 20+ years creating content and building six channels to Silver Play Button level, I have seen the SEO landscape for video evolve enormously. When I was on the vidIQ Creator Success team, we worked with thousands of creators on their discoverability — and one of the most underutilised techniques was implementing proper VideoObject schema markup. Most creators focus exclusively on YouTube’s internal search and never consider how their videos appear in Google Search. That is a mistake, because ranking YouTube videos on Google can deliver a massive additional stream of traffic.
In this guide, I am going to walk you through everything you need to know about YouTube video schema markup — what it is, why it matters, how to implement it correctly with real JSON-LD code examples, and the common mistakes I see creators make. Whether you run a personal blog, a business website, or a content hub alongside your YouTube channel, this is one of those technical optimisations that pays dividends for years to come.
Stop Guessing — Start Growing with vidIQ
The #1 YouTube growth tool trusted by millions of creators. Try it free and see why I recommend it to every channel I consult.
What Is Video Schema Markup?
Video schema markup is structured data code that you add to a webpage to tell search engines about a video embedded on that page. Using the VideoObject type from the schema.org vocabulary recognised by Google, it provides machine-readable information such as the video’s title, description, thumbnail, upload date, duration, and embed URL. This enables Google to display your video as an enhanced rich result in search — complete with a visual thumbnail, playable preview, and duration badge.
Think of it this way: without schema markup, Google sees your webpage as text and images. It may notice an embedded YouTube iframe, but it has to guess what the video is about. With proper VideoObject markup, you are essentially handing Google a structured summary of your video content on a silver platter. The result? Your page becomes eligible for video rich results, video carousels, and enhanced search listings that stand out far more than plain text results.
The preferred format for implementing this markup is JSON-LD (JavaScript Object Notation for Linked Data). Google officially recommends JSON-LD over alternative formats like Microdata or RDFa because it is easier to add, maintain, and debug. You place a single script tag in your page’s HTML, and the structured data lives completely separate from your visible content — clean, simple, and effective.
Key Takeaway: Schema markup is the bridge between your embedded YouTube videos and Google’s rich results. Without it, you are invisible in the enhanced search features that drive the highest click-through rates.
Why YouTube Video Schema Markup Matters for SEO
In my consulting work, I constantly see creators who are meticulous about their YouTube metadata — titles, descriptions, and tags — but completely neglect the structured data on their own websites. Here is why that matters more than most people realise:
1. Rich Results Dramatically Increase Click-Through Rates
A standard Google search result is a blue link with a title, URL, and text snippet. A video rich result includes a prominent thumbnail image, a duration badge, and sometimes a playable preview. The visual difference is enormous. In my experience across hundreds of channel audits, pages with video rich results consistently achieve 30% or higher CTR improvements compared to standard text listings. When users are scrolling through a page of blue links and one result has an eye-catching video thumbnail, that result wins the click.
2. Dual Ranking Opportunities
This is the strategy I recommend to every creator and business I consult with. When you embed a YouTube video on your own website and add proper schema markup, you create two potential search results for the same query: your YouTube video page on youtube.com and your website page with the embedded video. In some cases, you can dominate the search results page with both listings. This is especially powerful for branded searches and niche queries where competition is moderate. It is one of the core tactics I cover when helping clients with ranking videos on Google rather than just YouTube.
3. Enhanced Visibility in Video Carousels
Google frequently displays video carousels — horizontal scrollable rows of video results — for queries where video content is relevant. Proper VideoObject schema markup significantly increases your chances of appearing in these carousels. Without it, Google is far less likely to recognise your page as video content. I have seen pages jump into video carousels within days of adding correct structured data, going from zero video-related impressions to thousands.
4. Future-Proofing for AI-Powered Search
With Google increasingly integrating AI Overviews and AI-powered search features, structured data is becoming more important, not less. These systems rely heavily on structured, machine-readable data to understand and surface content. By implementing proper schema markup now, you are positioning your content to benefit from whatever search innovations come next. This is a topic I discuss regularly when advising on YouTube SEO strategies for 2026 and beyond.
Understanding VideoObject Schema: Required and Recommended Properties
Before you start writing code, you need to understand what information Google expects. The Google Search Central documentation on video structured data outlines both required and recommended properties. Here is a breakdown:
Required Properties
These are the absolute minimum — without them, Google will not recognise your markup as valid:
| Property | Description | Example |
|---|---|---|
| name | The title of the video | “How to Optimise YouTube Thumbnails” |
| description | A text description of the video | “Learn the essential steps to create click-worthy YouTube thumbnails…” |
| thumbnailUrl | URL to the video thumbnail image | “https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg” |
| uploadDate | Date the video was published (ISO 8601) | “2026-05-15T08:00:00+00:00” |
Recommended Properties
Including these significantly improves your chances of earning rich results and gives Google more context:
| Property | Description | Example Value |
|---|---|---|
| duration | Video length in ISO 8601 duration format | “PT12M35S” (12 min, 35 sec) |
| embedUrl | The embed URL for the video player | “https://www.youtube.com/embed/VIDEO_ID” |
| contentUrl | The URL of the actual video content | “https://www.youtube.com/watch?v=VIDEO_ID” |
| interactionStatistic | Engagement metrics (e.g., view count) | WatchAction with userInteractionCount |
| expires | When the video is no longer available | “2028-12-31T23:59:59+00:00” |
Important: Do not include the expires property if your video is intended to remain available indefinitely. Setting an expiration date will cause Google to remove the rich result after that date. Only use it for time-limited content like live event replays or promotional videos with an end date.
How to Implement YouTube Video Schema Markup: Step-by-Step
Now for the practical part. I am going to walk you through exactly how to create and add VideoObject schema markup for a YouTube video embedded on your website. I have implemented this process on my own sites and across dozens of client websites, so I know the pitfalls to avoid.
Step 1: Gather Your Video Metadata
Before writing any code, collect the following information from your YouTube video. You can find all of this in YouTube Studio or by using vidIQ’s video analytics dashboard:
- Video title — Use the exact title as it appears on YouTube
- Description — Write a concise summary (this can differ from your YouTube description; aim for 100-300 characters)
- Thumbnail URL — Use the highest resolution available:
https://i.ytimg.com/vi/YOUR_VIDEO_ID/maxresdefault.jpg - Upload date — The publication date in ISO 8601 format (e.g.,
2026-05-15T08:00:00+00:00) - Duration — Convert to ISO 8601 duration format (e.g., a 12-minute 35-second video becomes
PT12M35S) - Video ID — The 11-character identifier from your YouTube URL (the part after
v=)
Step 2: Write Your VideoObject JSON-LD Code
Here is a complete, production-ready example that includes all required and recommended properties. Replace the placeholder values with your actual video information:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "How to Optimise YouTube Thumbnails for Maximum CTR",
"description": "Learn the essential steps to create click-worthy YouTube thumbnails that increase your click-through rate and grow your channel.",
"thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
"uploadDate": "2026-05-15T08:00:00+00:00",
"duration": "PT12M35S",
"contentUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"embedUrl": "https://www.youtube.com/embed/dQw4w9WgXcQ",
"interactionStatistic": {
"@type": "InteractionCounter",
"interactionType": {
"@type": "WatchAction"
},
"userInteractionCount": 15420
},
"author": {
"@type": "Person",
"name": "Alan Spicer",
"url": "https://www.youtube.com/@AlanSpicer"
}
}
</script>
Let me break down the key points in this code:
- @context — Always set to
"https://schema.org", which tells search engines you are using the schema.org vocabulary - @type — Set to
"VideoObject"for video content - name — Must match or closely reflect your actual video title
- thumbnailUrl — Use the
maxresdefault.jpgversion for the highest quality thumbnail - duration — Uses ISO 8601 duration format: PT = Period Time, followed by hours (H), minutes (M), and seconds (S)
- contentUrl — The standard YouTube watch URL
- embedUrl — The embed version of the URL (note:
/embed/not/watch?v=) - interactionStatistic — The view count; update this periodically for accuracy
Step 3: Add the Code to Your Webpage
Where you place the JSON-LD code depends on your platform:
WordPress Users: The easiest approach is to use a plugin that handles this automatically. Rank Math Pro and Yoast SEO Premium both detect embedded YouTube videos and generate VideoObject markup. If you prefer manual control, use a plugin like WPCode (formerly Insert Headers and Footers) to add the JSON-LD to specific pages. Alternatively, paste it directly into a Custom HTML block in the WordPress editor.
Custom Websites: Place the <script type="application/ld+json"> tag anywhere in your page’s HTML. Google can read it from the <head> section or anywhere within the <body>. I prefer placing it in the head for cleanliness, but either works.
Squarespace, Wix, and Other Builders: Look for a “Custom Code” or “Header Code” injection option in your platform’s settings. Most modern website builders support this. If yours does not, you may need to upgrade to a plan that allows custom code injection.
Step 4: Validate Your Structured Data
This step is non-negotiable. Always test your markup before relying on it. Google provides two essential tools:
- Rich Results Test — Enter your page URL or paste your code directly. This tool shows whether your page is eligible for rich results and previews how it might appear in search. Pay attention to any warnings or errors.
- Schema Markup Validator — This validates your JSON-LD against the full schema.org specification. It catches issues that the Rich Results Test might not flag.
Pro Tip: I always test with the Rich Results Test first (to check Google’s specific requirements), then run the Schema Markup Validator as a secondary check. Fix any errors before moving on. Even small syntax mistakes — a missing comma, an unclosed bracket — will invalidate the entire block.
Step 5: Submit for Indexing in Google Search Console
After adding and validating your schema markup, tell Google to re-crawl the page. Open Google Search Console, go to the URL Inspection tool, enter your page URL, and click Request Indexing. This prompts Google to re-crawl the page faster than waiting for the next natural crawl cycle. Without this step, it can take weeks for Google to discover your updated structured data.
Step 6: Monitor Results in Search Console
Over the following days and weeks, check the Video section under Enhancements in Google Search Console. This report shows you:
- How many pages have valid video structured data
- Any errors or warnings Google found in your markup
- Which specific pages are eligible for video rich results
- Trends over time as you add schema to more pages
Advanced VideoObject Schema: Multiple Videos, Playlists, and Timestamps
Once you have the basics down, there are several advanced techniques I use on my own sites and recommend to clients for even better results.
Multiple Videos on One Page
If your page embeds more than one YouTube video, you should include a separate VideoObject for each. The cleanest approach is to use an ItemList wrapper or simply include multiple JSON-LD script tags — one per video. Google can parse multiple JSON-LD blocks on a single page without issues.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "ItemList",
"itemListElement": [
{
"@type": "VideoObject",
"position": 1,
"name": "YouTube SEO Basics for Beginners",
"description": "Learn the fundamentals of YouTube SEO...",
"thumbnailUrl": "https://i.ytimg.com/vi/VIDEO_ID_1/maxresdefault.jpg",
"uploadDate": "2026-03-10T08:00:00+00:00",
"duration": "PT15M22S",
"contentUrl": "https://www.youtube.com/watch?v=VIDEO_ID_1",
"embedUrl": "https://www.youtube.com/embed/VIDEO_ID_1"
},
{
"@type": "VideoObject",
"position": 2,
"name": "Advanced YouTube Keyword Research",
"description": "Take your keyword research to the next level...",
"thumbnailUrl": "https://i.ytimg.com/vi/VIDEO_ID_2/maxresdefault.jpg",
"uploadDate": "2026-04-05T08:00:00+00:00",
"duration": "PT18M47S",
"contentUrl": "https://www.youtube.com/watch?v=VIDEO_ID_2",
"embedUrl": "https://www.youtube.com/embed/VIDEO_ID_2"
}
]
}
</script>
Adding Clip Markup for Key Moments
One of the most powerful advanced features is Clip markup, which tells Google about specific sections within your video. This enables Key Moments in search results — those timestamp links that let users jump directly to relevant parts of your video. If you already use timestamps in your YouTube video descriptions, adding Clip markup reinforces those timestamps for Google.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "Complete YouTube SEO Guide 2026",
"description": "Everything you need to know about YouTube SEO in 2026.",
"thumbnailUrl": "https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg",
"uploadDate": "2026-05-01T08:00:00+00:00",
"duration": "PT25M10S",
"contentUrl": "https://www.youtube.com/watch?v=VIDEO_ID",
"embedUrl": "https://www.youtube.com/embed/VIDEO_ID",
"hasPart": [
{
"@type": "Clip",
"name": "What is YouTube SEO?",
"startOffset": 30,
"endOffset": 180,
"url": "https://www.youtube.com/watch?v=VIDEO_ID&t=30"
},
{
"@type": "Clip",
"name": "Keyword Research for YouTube",
"startOffset": 180,
"endOffset": 480,
"url": "https://www.youtube.com/watch?v=VIDEO_ID&t=180"
},
{
"@type": "Clip",
"name": "Optimising Titles and Descriptions",
"startOffset": 480,
"endOffset": 820,
"url": "https://www.youtube.com/watch?v=VIDEO_ID&t=480"
}
]
}
</script>
The startOffset and endOffset values are in seconds. Notice how the url property includes the timestamp parameter (&t=30) so Google can link directly to that moment. This is incredibly powerful for longer videos — users can jump straight to the section they need, and Google loves surfacing this granular content.
Combining VideoObject with Article Schema
If your page contains both a written article and an embedded video (like most of my blog posts), you can include both an Article schema and a VideoObject schema. You can even nest the VideoObject inside the Article using the video property:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "YouTube Video Schema Markup Guide",
"author": {
"@type": "Person",
"name": "Alan Spicer"
},
"datePublished": "2026-05-31",
"video": {
"@type": "VideoObject",
"name": "YouTube Schema Markup Tutorial",
"description": "Watch the video walkthrough of implementing schema markup.",
"thumbnailUrl": "https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg",
"uploadDate": "2026-05-31T08:00:00+00:00",
"duration": "PT14M22S",
"embedUrl": "https://www.youtube.com/embed/VIDEO_ID"
}
}
</script>
This nested approach tells Google that the video is a core part of the article content, not just a supplementary embed. I use this structure on every blog post that has an accompanying YouTube video.
How vidIQ Helps with Video SEO and Schema Optimisation
While vidIQ does not generate JSON-LD code for you, it is an indispensable tool in the schema markup workflow. From my time on the vidIQ Creator Success team and my ongoing use of the tool in every channel audit I conduct, here is how vidIQ supports the process:
- Keyword Research — vidIQ’s keyword tool helps you identify the search terms your video should target, which directly informs the
nameanddescriptionproperties in your schema markup. Optimised metadata leads to better structured data, which leads to better rich results. - Competitor Analysis — See what structured data your competitors are using by examining their pages. vidIQ helps you identify which videos rank for your target keywords so you can study their approach.
- Video Analytics — Pull view counts, engagement data, and publication dates directly from vidIQ’s dashboard to populate your schema properties accurately.
- SEO Score Tracking — Monitor how well your videos perform in both YouTube and Google search, helping you measure the impact of your schema markup implementation.
The combination of vidIQ for YouTube-side optimisation and proper schema markup for Google-side optimisation is what I consider the complete video SEO stack. Neither alone gives you the full picture.
Common Schema Markup Mistakes (and How to Avoid Them)
Over the years, I have reviewed dozens of websites where creators attempted to implement video schema markup but made errors that prevented it from working. Here are the most common mistakes I encounter:
Mistake 1: Using the Wrong Thumbnail URL
The thumbnailUrl must point to a publicly accessible image. I frequently see creators use thumbnail URLs from their WordPress media library that are behind a login wall, or use YouTube thumbnail URLs with incorrect formatting. Always use the standard YouTube thumbnail URL format: https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg. If the video does not have a custom thumbnail, fall back to hqdefault.jpg or sddefault.jpg.
Mistake 2: Incorrect Duration Format
The ISO 8601 duration format trips people up constantly. A 10-minute, 30-second video is PT10M30S, not 10:30 or 630 or 00:10:30. The format is: PT (Period Time) + hours H + minutes M + seconds S. A 1-hour, 5-minute, 12-second video would be PT1H5M12S. Get this wrong and Google will flag an error in your structured data.
Mistake 3: Missing or Malformed Upload Date
The uploadDate must be in ISO 8601 format: 2026-05-15T08:00:00+00:00. Common errors include using formats like 15/05/2026 or May 15, 2026. Google will not accept these. The date should reflect when the video was first published, not when you added the schema markup to your page.
Mistake 4: Schema Markup Without a Visible Video on the Page
This is a critical one. Google requires that the video described in your schema markup is actually visible on the page. If you add VideoObject JSON-LD but do not embed the corresponding YouTube video in your page content, Google may flag this as misleading structured data. The structured data must accurately describe content that users can see and interact with on the page. Never add video schema to a page that does not contain the actual video.
Mistake 5: Not Updating View Counts
If you include the interactionStatistic property (which I recommend), keep the view count reasonably current. Having a schema that says 500 views when the video actually has 50,000 will not cause a penalty, but it is inaccurate data. If you cannot update this regularly, it is better to omit the property entirely than to leave stale numbers. For sites with many videos, consider automating this with the YouTube Data API.
Warning: Never fabricate or inflate any values in your schema markup. Google explicitly warns against misleading structured data and may issue a manual action penalty against your entire site. Always ensure your schema accurately reflects the actual video content. Check the Google Search structured data spam policies for full details.
Schema Markup for YouTube Creators vs Businesses: Different Approaches
In my consulting work, the implementation strategy differs depending on whether I am working with a solo creator or a business. Here is how I approach each:
For Individual YouTube Creators
If you are a creator with a personal website or blog, focus on adding schema markup to your highest-performing and most strategically important video pages. You do not need to mark up every single video you have ever published. Start with:
- Your top 10-20 videos by search traffic (check YouTube Analytics for “YouTube Search” and “Google Search” traffic sources)
- Evergreen tutorial and how-to content that targets specific search queries
- Product review videos, which frequently earn video rich results
- Any video that already appears in Google search results — schema markup can help it earn the rich result enhancement
For Businesses and Brands
Businesses should take a more systematic approach. Every page on your website that contains an embedded video should have corresponding schema markup. This includes:
- Product pages with demo or explainer videos
- Landing pages with testimonial or overview videos
- Blog posts and resource pages with embedded tutorials
- FAQ pages with video answers
- Support and documentation pages with walkthrough videos
For businesses, I typically recommend automating schema generation through your CMS or using a dedicated structured data plugin, because manually maintaining schema for dozens or hundreds of pages is not sustainable.
Measuring the Impact of Video Schema Markup
You have implemented the markup, validated it, and submitted it for indexing. Now how do you know if it is actually working? Here are the metrics I track:
Google Search Console: Video Enhancements Report
This is your primary dashboard. Navigate to Enhancements > Video in Google Search Console. You will see a graph showing valid pages, pages with warnings, and pages with errors. Aim for 100% valid pages. If you see errors, click through to get specific details about what needs fixing on each page.
Search Performance: Filtering by Search Appearance
In the Performance section of Google Search Console, you can filter by Search Appearance and look for “Video” results. This shows you impressions, clicks, CTR, and average position specifically for your video rich results. Compare the CTR of pages with video rich results to pages without — you should see a noticeable improvement.
Traffic from Google to Your Website Pages
Use Google Analytics (or your preferred analytics tool) to track organic search traffic to the specific pages where you have added video schema markup. Look for increases in organic traffic after implementation. In my experience, pages that earn video rich results typically see a 15-40% increase in organic traffic within the first few months, though results vary by niche and competition level.
YouTube Video SEO and Schema Markup: The Complete Optimisation Checklist
To bring everything together, here is the checklist I use for every video I publish and embed on a website. This combines YouTube metadata optimisation with proper schema markup for a complete approach:
Before Publishing the Video on YouTube
- Research target keywords using vidIQ’s keyword research tool
- Craft an optimised title that includes the primary keyword naturally
- Write a detailed SEO-optimised video description with timestamps
- Design a compelling custom thumbnail
- Add relevant tags and hashtags
After Embedding the Video on Your Website
- Write substantial supporting content around the embedded video (at least 300 words)
- Create VideoObject JSON-LD with all required properties
- Include recommended properties (duration, embedUrl, interactionStatistic)
- Add Clip markup if the video has distinct sections
- Validate with Google’s Rich Results Test and Schema Markup Validator
- Submit the URL for re-indexing in Google Search Console
- Monitor the Video Enhancements report over the following weeks
Real-World Results: What I Have Seen from Schema Markup Implementation
Let me share some specific outcomes from my own experience and from clients I have worked with:
On my own website, adding VideoObject schema markup to my top 30 blog posts with embedded YouTube videos resulted in 22 of those pages earning video rich results within 6 weeks. The pages with rich results saw an average 34% increase in click-through rate from Google Search compared to their pre-schema performance. For one particularly competitive tutorial post, the video rich result moved it from position 7 to a visual standout at position 5 — and the CTR tripled because the thumbnail drew the eye past the higher-ranking text results.
One client I worked with — an online course creator in the fitness niche — had 45 blog posts with embedded YouTube tutorials but zero schema markup. After implementing VideoObject JSON-LD across all 45 pages, their organic search traffic from Google to those pages increased by 28% over three months. More importantly, their lead generation from those pages (course sign-ups originating from Google organic traffic) increased by 19%, because the video thumbnails in search results attracted more qualified, intent-driven visitors.
“Schema markup is not glamorous. Nobody is going to congratulate you for adding a JSON-LD script tag. But the creators who do it — consistently and correctly — have a quiet advantage over everyone else in their niche. It is one of those small things that compounds over time.”
Tools and Resources for Video Schema Markup
Here are the tools I recommend and personally use for implementing and maintaining video schema markup:
| Tool | Purpose | Cost |
|---|---|---|
| Google Rich Results Test | Test and preview rich results eligibility | Free |
| Schema Markup Validator | Validate JSON-LD against schema.org specification | Free |
| Google Search Console | Monitor indexing, rich results, and search performance | Free |
| vidIQ | Keyword research, competitor analysis, video analytics | Free tier available |
| Rank Math Pro (WordPress) | Automated video schema generation for WordPress | From $69/year |
| Yoast Video SEO (WordPress) | Dedicated video schema plugin for WordPress | From $79/year |
How Schema Markup Fits Into Your Broader YouTube SEO Strategy
Schema markup is one piece of a larger puzzle. It works best when combined with other YouTube SEO techniques that I cover across my content hub:
- YouTube-side SEO: Optimising your video’s title, description, and tags ensures your video ranks well within YouTube itself. Schema markup extends this to Google.
- Google-side SEO: Ranking your YouTube videos on Google requires a combination of on-page SEO, schema markup, and quality content surrounding the embedded video.
- Description optimisation: Using a proper video description template ensures consistency in the metadata you use for both YouTube and schema markup.
- Overall YouTube SEO: Understanding what has changed and what works in YouTube SEO in 2026 helps you prioritise where schema markup will have the biggest impact.
The creators and businesses I see achieving the best results are the ones who approach video SEO holistically — optimising on YouTube, optimising on their website, and connecting the two with proper structured data. It is not about doing one thing brilliantly; it is about doing everything competently and consistently.
Ready to Take Your Channel to the Next Level?
Get the tools AND the expertise. Try vidIQ for data-driven growth, or book a 1-on-1 call with me for a personalised strategy.
Frequently Asked Questions
What is YouTube video schema markup?
YouTube video schema markup is structured data code (typically in JSON-LD format) that you add to a webpage to tell Google and other search engines about an embedded YouTube video. It uses the VideoObject schema type to provide details like the video title, description, thumbnail URL, upload date, and duration. This helps search engines display your video content as rich results — enhanced search listings with video thumbnails, duration badges, and playable previews directly in Google Search results.
Does YouTube automatically generate schema markup for my videos?
YouTube itself adds structured data to your video’s watch page on youtube.com, which helps those pages appear in Google Search. However, if you embed a YouTube video on your own website, that structured data does not transfer. You need to manually add VideoObject schema markup to your webpage for Google to recognise and display your embedded video as a rich result. Most creators miss this because they assume YouTube handles everything automatically.
What are the required properties for VideoObject schema markup?
According to Google’s structured data guidelines, the required properties are: name (the video title), description (a text description), thumbnailUrl (a URL to the thumbnail image), and uploadDate (the publication date in ISO 8601 format). Google also strongly recommends including duration, contentUrl or embedUrl, and interactionStatistic for the best chance at earning rich results.
How do I test my video schema markup?
Google provides two official testing tools. The Rich Results Test at search.google.com/test/rich-results checks whether your page is eligible for rich results and previews how it might appear. The Schema Markup Validator at validator.schema.org validates your code against the full schema.org specification. Always test with both before publishing. Additionally, monitor the Video enhancements report in Google Search Console over time to catch any indexing issues.
Will video schema markup guarantee my video appears as a rich result?
No. Adding valid schema markup makes your page eligible for rich results, but Google decides whether to display them based on page quality, search relevance, user device, location, and competition. Without schema markup, however, your page is extremely unlikely to ever appear as a video rich result. Think of it as a necessary prerequisite rather than a guarantee.
What is the difference between JSON-LD and Microdata for video schema?
JSON-LD places structured data in a separate script tag, completely independent of your page content. Microdata embeds attributes directly into your HTML elements. Google officially recommends JSON-LD because it is easier to implement, maintain, and debug. It does not interfere with your page layout and can be added without modifying content HTML. For video schema, JSON-LD is the clear best practice in 2026.
Can I use schema markup to rank my YouTube video on Google instead of just YouTube?
Yes. By embedding your YouTube video on your own website and adding VideoObject schema markup, you create two potential search results for the same query — one from youtube.com and one from your website. This dual-ranking strategy is one of the most powerful SEO techniques I recommend to creators who have their own websites. Learn more about this in my guide on ranking YouTube videos on Google.
Do I need a WordPress plugin for video schema markup?
Not strictly, but plugins make it significantly easier. SEO plugins like Rank Math Pro or Yoast SEO Premium can automatically detect embedded videos and generate VideoObject schema. If you prefer manual control, you can add JSON-LD directly to your pages. For WordPress users who embed YouTube videos frequently, a dedicated video SEO plugin saves time and reduces errors.
How long does it take for Google to show video rich results?
After adding valid schema markup, it typically takes a few days to several weeks. Speed this up by submitting the URL in Google Search Console using the URL Inspection tool and requesting indexing. Monitor progress through the Video enhancements report, which shows valid items, warnings, and errors as Google processes your structured data.
Can video schema markup improve my click-through rate from Google Search?
Yes. Video rich results consistently achieve higher CTRs than standard text results. The thumbnail, duration badge, and visual preview make your listing stand out. In my consulting experience, pages with video rich results can see CTR improvements of 30% or more compared to standard listings. This increased visibility is one of the primary reasons implementing video schema is worth the effort.
Final Thoughts: Schema Markup Is the Quiet Advantage
Video schema markup is not the flashiest SEO technique. It will not go viral on social media. Nobody is going to be impressed when you tell them you added a JSON-LD script tag to your blog post. But in my 20+ years of creating content and working with hundreds of channels as a YouTube Certified Expert, I have learned that the biggest competitive advantages in SEO come from the things most people cannot be bothered to do.
Schema markup is one of those things. It takes 15-30 minutes per page to implement properly. It is free. It makes your content eligible for enhanced search features that dramatically increase visibility and click-through rates. And once it is in place, it works for you permanently — no ongoing cost, no maintenance headaches, just a quiet, compounding advantage.
If you have a website alongside your YouTube channel and you are not using structured data, start today. Pick your top five videos, add VideoObject schema markup, validate it, and submit it for indexing. Track the results over the next month. I am confident you will see the difference — and once you do, you will want to add it to every video page on your site.
And if you want expert help implementing this alongside a broader YouTube SEO strategy — whether that is keyword research, metadata optimisation, or a full channel audit — book a free discovery call and let us discuss your channel’s specific needs.
About Alan Spicer
Alan Spicer is a YouTube Certified Expert and 20+ year content creator with 6 Silver Play Buttons. A former vidIQ team member and certified YouTube consultant, Alan has helped hundreds of creators and businesses grow their channels through expert audits, coaching, and data-driven strategy. Learn more about Alan’s consulting services or book a free discovery call.
Discover more from Alan Spicer - YouTube Certified Expert
Subscribe to get the latest posts sent to your email.


















