.svg)
Video Technical SEO: Schema, Sitemaps, and Structured Data
Video content is one of the fastest-growing formats on the web. But while most marketers focus on production quality and platform algorithms, the technical layer that helps Google actually find, understand, and surface that video often gets ignored. Without the right structured data, a video sitemap, and proper hosting setup, Google may never index your video at all, even if it lives on a page that already ranks well.
This guide covers the technical implementation side of video SEO: what signals Google needs, how to write VideoObject schema correctly, how to build a video sitemap, and the common mistakes that quietly block video rich results.
What Google needs to index and rank video content
Google can detect video on a page, but detection is not the same as indexing. For Google to include your video in search results, including the video carousel and video tab, it needs to be able to crawl the video file or thumbnail, understand the video's metadata, and attribute it to a specific page.
According to Google's video indexing documentation, a video is eligible to appear in search results only when Google can identify a video on the page, fetch a thumbnail (from structured data or by crawling the file), and access a publicly accessible video file URL or streaming URL.
That last point trips up many sites. If the video is hosted behind a login wall, loaded only after user interaction, or embedded via a JavaScript player that Googlebot cannot render, the video will not be indexed. Google's crawler must be able to reach the video file directly.
Beyond crawlability, Google looks for three core signals to understand a video:
- Structured data: VideoObject schema on the page that declares the title, description, thumbnail URL, upload date, and content URL
- Video sitemap: A dedicated sitemap or sitemap extension that lists video URLs along with their metadata
- On-page context: The surrounding text content, heading hierarchy, and page title that reinforce what the video is about
Providing all three gives Google redundant signals that build confidence in the video's content and quality. Relying on just one, especially just embedding a video and hoping for the best, significantly reduces indexing rates.
If you want a broader grounding in how structured data works across content types, Rich Results and Structured Data: A Complete Guide is a useful starting point before diving into video-specific implementation.
VideoObject schema: the required and recommended properties
VideoObject schema is a type defined in the Schema.org vocabulary that communicates video metadata to search engines in a machine-readable format. Google uses it to populate video rich results, including the thumbnail, duration, and upload date displayed directly in the SERP.
Google requires the following properties for a video to be eligible for video rich results (source: Google Search Central):
- name: the title of the video
- description: a text description of the video content
- thumbnailUrl: a publicly accessible URL for the video thumbnail image; Google recommends a minimum resolution of 1200 pixels wide and a 16:9, 4:3, or 1:1 aspect ratio
- uploadDate: the date the video was first published, in ISO 8601 format (e.g., 2026-05-08)
Beyond the required fields, Google recommends including these properties to improve eligibility for enhanced features:
- contentUrl: the direct URL to the video file (not the page it is embedded on)
- embedUrl: the URL of an embeddable player (used when a direct file URL is not available)
- duration: the video length in ISO 8601 duration format (e.g., PT5M30S for 5 minutes and 30 seconds)
- expires: a date after which the video is no longer available, if applicable
- hasPart: for videos with chapters, an array of Clip objects with names and start/end timestamps
- regionsAllowed: countries where the video is accessible, using ISO 3166 country codes
A minimal but complete VideoObject implementation in JSON-LD looks like this:
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "How to Use Video Sitemaps for SEO",
"description": "A walkthrough of how to build and submit a video sitemap in Google Search Console.",
"thumbnailUrl": "https://example.com/images/video-sitemaps-thumb.jpg",
"uploadDate": "2026-05-08",
"duration": "PT7M15S",
"contentUrl": "https://example.com/videos/video-sitemaps.mp4",
"embedUrl": "https://www.youtube.com/embed/abc123"
}Place this JSON-LD block in the or of the page that hosts the video. One VideoObject block per video per page. If a page hosts multiple videos, each needs its own separate VideoObject block.
For a parallel look at how schema works for written content, Schema Markup for Blog Posts covers the same principles applied to Article and FAQPage types.
Video sitemaps: how to submit video content to Google
A video sitemap is either a standalone XML sitemap or an extension added to your existing sitemap that provides Google with a structured list of video URLs and their metadata. It is one of the most reliable ways to ensure Google finds your video content, especially on sites that publish video regularly.
Google documents the full video sitemap schema at Google Search Central. The core structure uses a
A basic video sitemap entry looks like this:
<url>
<loc>https://example.com/blog/video-sitemaps-for-seo</loc>
<video:video>
<video:thumbnail_loc>https://example.com/images/video-sitemaps-thumb.jpg</video:thumbnail_loc>
<video:title>How to Use Video Sitemaps for SEO</video:title>
<video:description>A walkthrough of how to build and submit a video sitemap in Google Search Console.</video:description>
<video:content_loc>https://example.com/videos/video-sitemaps.mp4</video:content_loc>
<video:duration>435</video:duration>
<video:publication_date>2026-05-08T00:00:00+00:00</video:publication_date>
</video:video>
</url>A few key points on video sitemaps:
- The
- Duration is expressed in seconds (not ISO 8601 format, which is used in schema)
- Google accepts video sitemaps with up to 50,000 URL entries per file; if you have more, split them across multiple sitemaps
Once your video sitemap is built, submit it through Google Search Console under the Sitemaps report. You can also reference it in your robots.txt file using a Sitemap: directive so Googlebot discovers it automatically on every crawl.
Hosted video versus embedded video: SEO implications
Where a video is hosted determines which domain receives the SEO value from that video's indexing.
When you self-host a video, the file lives on your own server or CDN. Google indexes the video in association with your domain, and clicks from the video carousel go back to your site. You also have full control over the contentUrl in your VideoObject schema, giving Google the clearest possible signal about the file.
When you embed a YouTube or Vimeo video, the file is hosted on that platform. Google may index the video on YouTube's domain rather than yours. Your page can still rank for the topic using the embedUrl property in schema, but video carousel entries are more likely to send users to YouTube directly.
A common middle-ground approach is to publish video on YouTube for reach, then embed it on your own site with complete VideoObject schema. This does not fully capture the video indexing benefit for your domain, but it does help your page rank for the topic in standard results.
The Video SEO Guide covers the full strategic picture of balancing platform hosting with organic search goals.
Common video technical SEO mistakes and how to fix them
Most video SEO failures are not about content quality. They are about implementation gaps that prevent Google from accessing or understanding the video. These are the most common mistakes and how to address each one.
Missing or incomplete VideoObject schema
Many sites either skip schema entirely or include only the required fields and omit recommended ones like duration and contentUrl. Without contentUrl or embedUrl, Google cannot confirm where the video file lives, which reduces confidence and may prevent the video from appearing in rich results.
Fix: Audit every video page with Google's Rich Results Test to verify schema is valid and all recommended fields are populated.
Thumbnail images that fail Google's requirements
Google will not generate a thumbnail from schema if the image URL is inaccessible, too small, or in an unsupported format. A missing thumbnail disqualifies the video from rich results entirely.
Fix: Host thumbnails as publicly accessible JPEG or PNG files at a minimum of 1200 pixels wide. Avoid thumbnail URLs that require authentication or redirect through JavaScript.
Video content loaded via JavaScript only
If your video player renders entirely through JavaScript and Googlebot's crawler cannot execute that script, the video will not be detected. This is especially common with custom players, lazy-loaded embeds, and single-page application frameworks.
Fix: Use server-side rendering for the video embed where possible, or ensure the video thumbnail and structured data are present in the initial HTML response even if the player itself loads dynamically.
No video sitemap submitted
Relying on Googlebot to discover video content through regular crawling alone is slow and unreliable, especially for sites that publish video frequently. Without a sitemap, new videos may not be indexed for weeks.
Fix: Build a video sitemap and submit it through Google Search Console. For sites using a CMS, many SEO plugins can generate video sitemaps automatically if configured correctly.
Schema placed on the wrong page
VideoObject schema must be placed on the page that hosts the video, not on a separate video archive page or a category page. If the schema URL and the page URL do not match, Google will treat the structured data as invalid.
Fix: Always verify that the page URL in your sitemap's
Video technical SEO is the foundation that determines whether your video content is invisible to Google or actively driving organic traffic. Getting VideoObject schema right, submitting a video sitemap, and choosing a hosting approach that allows Google to crawl the video file are the three highest-impact moves available. Most sites skip at least one. Start with a structured data audit using Google's Rich Results Test, fill in missing schema properties, and build your video sitemap if you do not have one yet. For platform-specific optimization that builds on this technical layer, the YouTube SEO guide is the logical next read.
Recommended Posts
.svg)