Google SEO optimization (Web Player)

When Google is able to crawl video SEO information, your videos can experience the following benefits.

  • Be eligible for ranking in Google searches
  • Gain more web traffic
  • Appear in Google Search results with Key Moments and motion thumbnails

To enable Google to crawl the SEO information of your videos, JWP has incorporated Google SEO optimizations into the video player to ensure Google’s Search Crawlers can effectively read JWP’s SEO object.


JW Player 8.26.1+Either the JavaScript single line embed or the advanced, on-page embeds can be used.

iFrame-based embeds from the JWP dashboard cannot currently be used with this feature.
Video registration Video content must be hosted with JWP or if your content is not hosted with JWP, be sure to register your external URLs to get media IDs.
Video Metadata is providedEach video must have the following metadata:

  • Title
  • Description
  • Thumbnail
Non-protected video content Even if Google Search Optimized is enabled, protected media types cannot be indexed by Google's search crawlers, such as the following:

  • Videos with DRM enabled
  • Token-signed videos
Include video sitemaps Video sitemaps are highly recommended to help with the indexing of videos by Google Search crawlers. Refer to Google’s sitemap documentation for more details.
Configure robots.txt Enable robots to crawl your pages in the robots.txt file.

Enable Google Search Optimized

When Google Search Optimized is enabled, the video player will load with structured data that Google search crawlers use to index video content.

We recommend enabling this feature for the following use cases:

  • One video player per page with the player in focus on page load
  • Players in which the first video loaded for the video player is static for the page URL


    If the first video in focus is dynamic, Google’s indexing may not accurately reflect what loads on the page.

There are two ways to enable Google Search Optimization for JWP.


If you are a developer or have developer resources, you can enable Google Search Optimization in the web player's configuration object.

Use the following step to enable Google Search Optimized:

  1. When initializing the player, set "generateSEOMetadata": true within setup().


You may also enable Google Search Optimized from your JWP Dashboard.

  1. From your Players page, create a new player or select an existing player.
  2. On the Players page, under the Configuration column click Advanced Options.
  3. Set the Google Search Optimized toggle to ON .

Key Moments

When Google Search Optimized is enabled, Key Moments is automatically enabled. Key Moments allows users to navigate video segments like chapters in a book within Google Search. To determine a Key Moment, Google Search Crawlers use one of the methods in the following table.

Editor SelectedIf a web video text track (.vtt) file with defined chapters is associated with the video, the chapters will be proposed to the Google Search Crawlers as Key Moments to show up in Google Search.

You can define specific timestamps of interest by adding chapters to a media item in your JWP library.
Video analysis (Default) If no .vtt file is detected, Google Search Crawlers may automatically determine Key Moments based on AI.

Video SEO Best Practices

In addition to enabling JWP's Google Search Optimized feature, it is generally recommended that SEO is enabled on a page where the first video loaded is connected with the page itself. This includes single video players, single video players with recommendations, and promoted content.

For more best practices information, refer to Google Video Best Practices.

Verify Google indexing status

There are two primary ways that Google offers to verify a page’s indexing status: Google Search Console and Google Rich Results Test.

With regard to JW Player results, there should be a Video section detected. The presence of a video section can be verified using Google’s Rich Results Status reports or URL Inspection Tool.

Additionally, Google offers two reports to verify video indexing status: Video Enhancement Report and Video Indexing Report. JWP recommends that all issues and warnings are resolved in both reports to help ensure optimal indexing.


What is ?jw_start= in the URL indexed by Google?

?jw_start= is used as a URL query parameter to let the video player know where to start the video with the value denoted in seconds. It will be used by all video players on the page where the JWP Google Search Optimized feature is turned on. Thus, it is recommended that this feature is only turned on for one video player on any page.

What does the JWP Google SEO feature add to a webpage?

There are three important pieces of structured data to have for indexing videos that the JWP Google Search Optimization feature will populate as part of the video player loading.

What do I do if my webpage already has a VideoOject?

It is best to only have one VideoObject on any page that focuses on the primary video. If you are already populating any of these video SEO structured data objects, we recommend one of the following options.

Option 1 - Remove the VideoObject generated by your website’s CMS and use JWP’s version through the steps described in this article.

Option 2 - Keep the VideoObject generated by your website’s CMS. Typical reasons for this selection would be that you want to retain your own VideoObject if it’s integrated with existing SEO structured data. The following steps will help to implement this

  1. For the Clip object, add the ?jw_start= URL query parameter as part of the URL field for each Key Moment that you want to specify with the appropriate time in seconds to start the video. For example:
    "url": ""
  2. For the SeekToAction object, add the ?jw_start= URL query parameter as part of the target and startOffset-input. For example:
    • "target":"{seek_to_second_number}"
    • "startOffset-input":"required name=seek_to_second_number"
  3. The numerical value should then be parsed from the ?jw_start= URL query parameter and passed into the starttime parameter during JWP setup.