Tube Site Script
Traffic and revenue

Video sitemaps and VideoObject structured data: what to include and how to submit

What a video sitemap contains, how VideoObject structured data works, how to split large sitemaps and how to submit them in webmaster tools.

Updated 3 minute read The Tube Site Script team

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:

FieldPurpose
locThe URL of the page that shows the video
video:thumbnail_locThe thumbnail image URL
video:titleThe video title
video:descriptionA short description
video:content_loc or video:player_locThe video file, or the player URL
video:durationLength in seconds
video:publication_dateWhen the video was published
video:family_friendlySet 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

  1. Verify each domain in the search engine's webmaster tools. Every site in a network is a separate property.
  2. Add the sitemap or sitemap index URL in the sitemaps section.
  3. Reference the sitemap in robots.txt with a Sitemap: line, which lets other search engines find it.
  4. Check the reports after a few days for errors, such as missing thumbnails or URLs that cannot be fetched.
  5. 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.

Get three guides like this every month, plus software update notices.Subscribe →