Embed contextually relevant videos with Article Matching

Last Updated: February 6, 2019

If you would like to try this Beta product, please contact our team.

Article Matching allows you to embed contextually relevant videos from your library into your articles. By making an addition to the playlist property, this feature provides you the following benefits:


  • An automated solution to embed contextually relevant videos into your articles with no additional editorial resources
  • Increased reach and monetization opportunities for your videos with minimal editorial involvement
  • Articles paired with a playlist of the most relevant videos from your hosted or registered videos
  • Potential for increased video engagement
You must be using either cloud-hosted or self-hosted JW Player 8.5.6+.


Use the following steps to implement Article Matching:

  1. Create a video search playlist in your JW Player dashboard.
  2. On the DEVELOPER RESOURCES tab of the video search playlist, copy the JSON URL.
  3. In the JSON URL, replace ?search={video-name} with ?contextual=true&search=__CONTEXTUAL__.

    The contextual and search parameters must not be changed. These parameters enable Article Matching and populate the Opengraph or HTML title at runtime.
  4. (Optional) Add parameters from the /v2/playlist/{playlist_id} route to the JSON URL to refine results.
  5. Add the updated JSON URL to the playlist object of a player that is in your article or template.

For example:

jwplayer("myElement").setup({
  "playlist": "https://cdn.jwplayer.com/v2/playlists/1234abcd?contextual=true&search=__CONTEXTUAL__",
  "height": 360,
  "width": 640,
  "autostart": "viewable"
});


Be sure to read these FAQs for more information about Article Matching.