A video sitemap is a structured XML file that informs search engines about the details of video content hosted on a website. Unlike a standard sitemap, which only provides URLs of pages, a video sitemap includes specific metadata such as the title, description, thumbnail, duration, and playback location of videos. By supplying this data in a structured way, search engines can more effectively index video content and make it discoverable in search results.

Core Structure of a Video Sitemap

The base of a video sitemap is an XML <urlset>. Each <url> element represents a page on your site that contains a video. Inside it, a <video:video> block holds all metadata about the video.

For example, you specify the page URL in <loc> and then describe the video inside <video:video>. This creates a direct connection between the page and the video file.

code
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">

<url>
<loc>https://example.com/video-page</loc>
<video:video>
<video:thumbnail_loc>https://example.com/thumbnails/video1.jpg</video:thumbnail_loc>
<video:title>Product Demo</video:title>
<video:description>Demonstration of the new product features.</video:description>
<video:content_loc>https://cdn.example.com/videos/video1.mp4</video:content_loc>
<video:duration>120</video:duration>
<video:publication_date>2025-09-24T08:00:00+00:00</video:publication_date>
</video:video>
</url>

</urlset>
Banner for Metadata

Required Fields

For a video sitemap to be valid, certain elements must be included. Each video must have a thumbnail URL that provides a preview image, a title that summarizes the content, and a description that offers more context about the video.

Additionally, either a direct content URL or a player URL must be provided to indicate how the video can be accessed. Without these fields, search engines cannot properly process the entry, which may result in the video being excluded from indexing.

While required fields establish the basic structure, optional fields add detail that improves indexing and ranking. For example, specifying the duration helps search engines understand video length, while including the publication date indicates when the content was made available.

Expiration dates are useful for time-sensitive videos such as promotions or events. Metadata like view count, tags, and platform availability can further refine how the video is presented and matched to user queries. Although optional, these fields strengthen the chances of proper indexing and visibility.

Hosting Considerations

The video sitemap file must be hosted in a publicly accessible location, usually at the root directory ( /video-sitemap.xml) of the site, so that search engines can locate it. For websites with a large number of videos, multiple sitemap files may be required because a single sitemap can only contain up to 50,000 URLs. In such cases, an index sitemap can be created to reference all video sitemaps. To ensure search engines find the sitemap, it should also be referenced in the site"s robots.txt file.

code
Sitemap: https://example.com/video-sitemap.xml

Dynamic Video Sitemap Generation

For websites with frequently updated or user-generated video content, manually maintaining a video sitemap is inefficient. Instead, sitemaps can be generated dynamically through the backend. For example, an API-driven application can query its database for new videos and automatically generate an XML response.

This ensures that each new video is reflected in the sitemap without requiring manual edits. Dynamic generation also helps maintain accurate metadata, such as updated publication dates and thumbnail links, which might otherwise fall out of sync with actual content.

code
app.get('/video-sitemap.xml', (req, res) => {
res.header('Content-Type', 'application/xml');
res.send(`<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
<url>
<loc>https://example.com/video-page</loc>
<video:video>
<video:thumbnail_loc>https://example.com/thumb.jpg</video:thumbnail_loc>
<video:title>Dynamic Video</video:title>
<video:description>Generated via API</video:description>
<video:content_loc>https://cdn.example.com/video.mp4</video:content_loc>
</video:video>
</url>
</urlset>`);
});

Validation

Once the video sitemap is created, it must be validated to ensure proper indexing. XML schema validation confirms that the structure follows the required syntax. Tools like Google Search Console allow developers to submit the sitemap and review indexing status.

This process highlights any errors, such as missing thumbnails or invalid durations, and provides insights into which videos are being indexed successfully. Regular validation and monitoring are essential to confirm that new videos continue to be included as they are added.