How to Fix Missing Video Entries in Your XML Sitemap
Your audit found pages with videos (native <video> tags, YouTube or Vimeo iframes, or click-to-play facades), but none of your sitemaps contain video entries. By the end of this guide you will have a valid video sitemap, or video tags added to your existing sitemap, that is linked from your sitemap index and robots.txt and submitted to Google Search Console.

Why it matters
Search engines often miss videos that load through iframes, JavaScript players or lazy facades, because the actual player is not in the initial HTML. A video sitemap lists each video's title, thumbnail and player URL, so crawlers can find it without rendering the page. That helps videos appear in Google's video results, the Videos tab and video rich results.
It also gives AI search features clean metadata to cite. The ranking effect is small, but on pages where the video is the main content, it decides whether the video gets indexed at all.
What you need
Step-by-step fix
List every page that contains a video
Crawl your site with Screaming Frog, Sitebulb or your CMS's media library. Find pages that contain any of these:
- a
<video>element - an iframe from youtube.com, youtube-nocookie.com, player.vimeo.com, Wistia or a similar host
- a click-to-play facade such as
lite-youtubeorlite-vimeo
Export the page URLs to a spreadsheet. Then mark which pages have the video as their main content. Since late 2023, Google only indexes videos on pages where the video is the main content, so those pages matter most.
Collect the required metadata for each video
Each video entry needs four things:
- title
- description (maximum 2,048 characters)
- thumbnail URL: at least 160×90 px, JPG, PNG or WebP, and crawlable
- either a direct file URL (
content_loc) or a player URL (player_loc)
For YouTube, use https://www.youtube.com/embed/VIDEO_ID as the player URL and https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg as the thumbnail. For Vimeo, use https://player.vimeo.com/video/VIDEO_ID. Also record the duration in seconds and the publication date if you have them.
Build the video sitemap XML
xml. Declare the video namespace on the <urlset> element. Add one <url> per page, where <loc>` is your page URL, not the video file.
Put one <video:video> block per video inside that <url>. Do not use deprecated tags such as video:category, video:gallery_loc or video:price; Google no longer uses them. Escape & as & inside URLs.
<?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/product-demo</loc>
<video:video>
<video:thumbnail_loc>https://example.com/media/demo-thumb.jpg</video:thumbnail_loc>
<video:title>Example Co Product Demo</video:title>
<video:description>A 3-minute walkthrough of setting up the Example Co dashboard.</video:description>
<video:player_loc>https://www.youtube.com/embed/AbC123xYz</video:player_loc>
<video:duration>184</video:duration>
<video:publication_date>2026-01-15T09:00:00+00:00</video:publication_date>
<video:family_friendly>yes</video:family_friendly>
</video:video>
</url>
<url>
<loc>https://example.com/tutorials/install</loc>
<video:video>
<video:thumbnail_loc>https://example.com/media/install-thumb.jpg</video:thumbnail_loc>
<video:title>Installing Example Co</video:title>
<video:description>Step-by-step install guide for Example Co on Windows and macOS.</video:description>
<video:content_loc>https://example.com/media/install.mp4</video:content_loc>
<video:duration>312</video:duration>
</video:video>
</url>
</urlset>Publish the file and link it from your sitemap index
Upload the file to your site root so it loads at https://example.com/video-sitemap.xml with a 200 status and an XML content type. Add it to your sitemap index so crawlers and audit tools that start from /sitemap.xml can find it.
<?xml version="1.0" encoding="UTF-8"?> <sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> <sitemap><loc>https://example.com/page-sitemap.xml</loc></sitemap> <sitemap><loc>https://example.com/video-sitemap.xml</loc></sitemap> </sitemapindex>
Reference the sitemap in robots.txt
Add a Sitemap: line for the sitemap index, or for the video sitemap directly, to https://example.com/robots.txt. Bing, Google and most audit crawlers read this line to discover sitemaps.
User-agent: * Allow: / Sitemap: https://example.com/sitemap.xml Sitemap: https://example.com/video-sitemap.xml
Keep the sitemap in sync when videos change
Generate the video sitemap from your CMS or build process, not by hand, so new videos are added automatically. When you remove a video or make it private, remove its entry as well. Entries pointing to unavailable videos create errors in Search Console.
Submit and verify the result
xml` and click Submit. The status should read Success with a discovered video count. After a few days, open Indexing > Video pages to see which videos were indexed and why others were not.
In Bing Webmaster Tools, submit the same URL under Sitemaps. Then re-run your site audit.
curl -s https://example.com/video-sitemap.xml | grep -c "<video:video>"
Platform-specific notes
WordPress
Yoast SEO needs the paid Video SEO add-on, which creates /video-sitemap.xml and adds it to /sitemap_index.xml. Rank Math PRO includes a video sitemap: enable it under Rank Math SEO > Sitemap Settings > Video Sitemap, and turn on 'Auto Detect Video' in Titles & Meta so embedded YouTube and Vimeo videos are picked up. The free versions of both plugins do not output video entries.
Next.js
In the App Router, app/sitemap.ts accepts a `videos` array on each entry (Next.js 15+). Each video takes `title`, `thumbnail_loc`, `description` and `content_loc` or `player_loc`, plus optional `duration`. Next.js adds the video namespace automatically. On older versions, generate the XML in a route handler (app/video-sitemap.xml/route.ts) and return it with Content-Type: application/xml.
Shopify
Shopify's auto-generated sitemap.xml cannot be edited and has no video entries. You also cannot upload files to your root domain. Use an SEO app that generates a video sitemap on a proxied path such as /apps/…, or add VideoObject structured data in your theme. Then add a Sitemap: line for the app's sitemap URL in robots.txt.liquid (Online Store > Themes > Edit code > Templates > add robots.txt template).
Webflow
Go to Site settings > SEO > Sitemap, turn off 'Auto-generate sitemap', and paste your own XML including the video namespace and <video:video> blocks. You then maintain all page URLs manually. Republish after every change.
Wix
Wix generates sitemaps automatically, and you cannot add custom video entries. Videos uploaded through Wix Video may be included in Wix's own sitemaps; check the sub-sitemaps listed at /sitemap.xml. For YouTube embeds, add VideoObject markup through SEO Settings > structured data, and submit your sitemap in Search Console.
Check that it worked
✅ How to verify
- Open https://example.com/sitemap.xml and confirm it links to a sitemap that contains <video:video> elements with the xmlns:video namespace declared.
- Run `curl -s https://example.com/video-sitemap.xml | grep -c "<video:video>"` and confirm the count roughly matches the number of video pages you listed.
- Check Google Search Console > Indexing > Sitemaps for a 'Success' status, then Indexing > Video pages for indexed videos.
- Re-run the site audit and confirm the check reports that the sitemap includes video entries.
⚠️ Common mistakes
- Putting the YouTube or MP4 URL in <loc>. <loc> must be your own page URL; the video URL belongs in video:player_loc or video:content_loc.
- Forgetting the xmlns:video namespace on <urlset>, which makes the video tags invalid and causes them to be ignored.
- Creating video-sitemap.xml but not linking it from the sitemap index or robots.txt, so crawlers and audit tools never find it.
- Listing pages where the video is a minor element, such as a small footer embed. Google will not index those videos and reports 'Video isn't on the main content of the page'.
Is this still an issue on your site? Run a free audit — ZORO checks this and 294 other SEO, AI-visibility, accessibility and security signals, with fixes for your platform.
Check my site freeFAQ
Do I need a separate video sitemap or can I use my existing sitemap?
Either works. You can add <video:video> blocks inside the existing <url> entries of your current sitemap, as long as you declare xmlns:video on <urlset>. A separate video-sitemap.xml is easier to maintain and debug, but it must be listed in your sitemap index or robots.txt.
Can I include YouTube videos embedded on my site in a video sitemap?
Yes. Use your page URL as <loc> and https://www.youtube.com/embed/VIDEO_ID as <video:player_loc>, plus a thumbnail, title and description. Google may still show the youtube.com version in results, but listing the embed helps your page compete for the video result.
Is a video sitemap still needed if I have VideoObject structured data?
They complement each other. Structured data describes the video once Google renders the page. The sitemap lets Google discover video pages and player URLs without rendering, which matters for lazy-loaded players and click-to-play facades. Google recommends using both.
How many videos can one video sitemap contain?
One sitemap file can hold up to 50,000 <url> entries and must be 50 MB or smaller uncompressed. If you have more, split the file and list each part in a sitemap index.
How to Fix Thin Content: Expand or Merge Pages Under 300 Words
How to Fix Heavy YouTube and Vimeo Embeds with Facades
How to Fix Duplicate Content Across Pages on Your Website
How to Fix Content Freshness: Dates, Updates & Last-Modified
How to Fix Missing VideoObject Schema on Video Pages