A video sitemap is an XML file that lists the video pages on your site along with details about each video, such as the title, description, thumbnail, duration and where the video can be played. VideoObject structured data does a similar job inside each video page. Together they help search engines find your videos, understand them and show them with a thumbnail in results. You submit the sitemap once in each search engine's webmaster tools and keep it updated automatically.
What a video sitemap contains
A video sitemap uses the standard sitemap format with an extra video namespace. Each entry is a page URL with one or more video blocks. The common fields are:
| Field | Purpose |
|---|---|
loc | The URL of the page that shows the video |
video:thumbnail_loc | The thumbnail image URL |
video:title | The video title |
video:description | A short description |
video:content_loc or video:player_loc | The video file, or the player URL |
video:duration | Length in seconds |
video:publication_date | When the video was published |
video:family_friendly | Set to no for adult content |
Check the current documentation of each search engine for the exact fields it supports, as these change from time to time.
Sitemap size and structure
A single sitemap file is limited to 50,000 URLs and 50 MB uncompressed. Large tube sites therefore split their sitemaps into several files and list them in a sitemap index. A sensible approach is to split by date or by number and to regenerate files as new videos are published, so the newest videos appear quickly.
Only list pages you want indexed. Do not include videos that are unpublished, removed, scheduled for later or marked noindex. Listing pages that return errors wastes crawl time and makes the sitemap less trustworthy.
VideoObject structured data
Structured data is a block of JSON-LD in the page that describes the video using the schema.org VideoObject type. Common properties are name, description, thumbnailUrl, uploadDate, duration (in ISO 8601 format such as PT8M30S), contentUrl and embedUrl. Keep the values consistent with what the page shows: the same title, the same thumbnail and the same duration.
Structured data does not guarantee a rich result. Search engines decide for themselves whether to show a video thumbnail, and they need the video to be the main content of the page and the thumbnail to be accessible to their crawlers.
Making sure crawlers can reach the media
- Do not block thumbnail or video folders in
robots.txt. - If you use a CDN, make sure it does not block search engine crawlers.
- If you protect video files with signed, expiring links, point the sitemap at the page and player rather than a link that will expire, or make sure the link is valid when crawled.
- Age gates should not prevent crawlers from seeing the page content. Check how your age gate behaves for crawlers, and check the rules that apply to you on this point.
Submitting to search engines
- Verify each domain in the search engine's webmaster tools. Every site in a network is a separate property.
- Add the sitemap or sitemap index URL in the sitemaps section.
- Reference the sitemap in
robots.txtwith aSitemap:line, which lets other search engines find it. - Check the reports after a few days for errors, such as missing thumbnails or URLs that cannot be fetched.
- Watch the video indexing reports over the following weeks to see how many pages are recognised as video pages.
Common mistakes
- Thumbnails that return errors or redirect to a login or age page.
- Sitemaps that list every video on a network even though each site only shows some of them.
- Durations or titles that do not match the page.
- Very thin pages where the video is not clearly the main content.
A sitemap is one part of a wider plan. See SEO for tube sites for titles, categories and internal links, and growing tube site traffic for other sources.
How Tube Site Script helps
Tube Site Script generates a video sitemap for every site in your network, along with a per-site robots.txt and RSS feed. Pages include JSON-LD structured data and Open Graph and Twitter cards. Since each site in a network chooses its own content and release schedule, having a separate sitemap per domain keeps each site's submission tied to that site.
You still verify each domain and submit its sitemap in the search engines' tools yourself. See the tube site software features and pricing.
Frequently asked questions
How many videos can one sitemap hold?
A single sitemap file can list up to 50,000 URLs and be up to 50 MB uncompressed. Larger sites use several files listed in a sitemap index.
Do I need both a video sitemap and structured data?
They complement each other. The sitemap helps search engines find video pages, and structured data describes the video on the page itself.
Does a video sitemap guarantee video thumbnails in results?
No. Search engines decide whether to show a rich video result, based on the page, the thumbnail and their own policies.
