This is a beta offering. By using this documentation, you are agreeing to abide by the terms of the JW Player Beta Program Agreement. If you would like to try this Beta product, please contact our team.
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.25.7+
iFrame-based embeds from the JWP dashboard cannot currently be used with this feature.
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 provided
Each video must have the following metadata:
For more info on adding metadata, refer to https://support.jwplayer.com/articles/edit-video-metadata
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:
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.
Enable robots to crawl your pages in the robots.txt file.
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
NOTE: 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:
- When initializing the player, set
You may also enable Google Search Optimized from your JWP Dashboard.
- From your Players page, create a new player or select an existing player
- On the Players page, under the Configuration column click Advanced Options.
- Set the Google Search Optimized toggle to ON
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.
If 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 creating a chapter .vtt file and associating it with a media item in your JWP library.
(Default) If no .vtt file is detected, Google Search Crawlers may automatically determine Key Moments based on AI.
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.
?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.
- VideoObject - General video indexing
- Clip - Editor selected key moments
- SeekToAction - Video analysis selected key moments
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
- For the
Clipobject, 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:
- For the
SeekToActionobject, add the
?jw_start=URL query parameter as part of the target and startOffset-input. For example:
- The numerical value should then be parsed from the
?jw_start=URL query parameter and passed into the starttime parameter during JWP setup.
Updated about 1 month ago