Embed contextually relevant videos with Article Matching

Article Matching allows you to embed contextually relevant videos from your library into your articles. By making a simple addition to the player setup, this feature provides you the following benefits:

  • An automated solution to embed contextually relevant videos from your JWP library into your articles with no additional editorial resources
  • Increased reach and monetization opportunities for your videos with minimal editorial involvement
  • Potential for increased video engagement

When a viewer visits your page, the proprietary Article Matching algorithm uses page metadata to search the metadata of your hosted or registered videos. With the results of the search, a playlist of videos that is relevant to an article is displayed and played in the HTML5 player. In the event that the search results do not return a relevant video, a trending video playlist appears.

Supported Languages

Article Matching supports the languages listed below.

Arabic (ar)Chinese (zh-Hans, zh-Hant)Czech (cs)Danish (da)
Dutch (nl)English (en)Finnish (fi)French (fr)
German (de)Greek (el)Hindi (hi)Hungarian (hu)
Indonesian (id)Italian (it)Japanese (ja)Korean (ko)
Norwegian (no)Portugese (pt-BR, pt-PT)Romanian (ro)Spanish (es)
Swedish (sv)Thai (th)Turkish (tr)



If you are a developer or have developer resources, you can enable Article Matching using these steps.

Use the following steps to add Article Matching on your page with a single line of code:

  1. Create an Article Matching playlist.
  2. Click EMBED.
  3. On the pop-up screen, select a Player from the dropdown menu.
  4. Copy the Embed Code. If you are adding Article Matching to an iframe, copy the code on the IFRAME tab.
  5. Click CLOSE.
  6. Paste the embed code at the location on your page where the player should appear.
<!-- standard embed -->
    <script src="https://cdn.jwplayer.com/players/{PLAYLIST_ID}-{PLAYER_ID}.js?search=__CONTEXTUAL__"></script>  
<!-- iframe embed -->  
    <div style="position:relative; overflow:hidden; padding-bottom:56.25%">  <script  id="jw-iframe-embed-{PLAYLIST_ID}-{PLAYER_ID}"  type="text/javascript"  async  src="https://cdn.jwplayer.com/iframe-embed/{PLAYLIST_ID}-{PLAYER_ID}.js"></script></div>  


Below are several frequently asked questions about Article Matching.

What data does JWP use for Article Matching?

Article Matching uses the Open Graph title of the article (or the HTML title if there is no Open Graph title), page description, and other page metadata to run a search query against the metadata of the hosted or registered videos in your library.

To ensure the best performance, be sure to add metadata to each of your videos.

Does Article Matching work when the HTML5 player is in an iframe?


Do I need to create a new player to use Article Matching?

Although you do not need to create a new player, we strongly recommend that you create a new player (see instructions below), new ad schedule, and new demand line items in your ad server. Doing this will allow to separate the stats and performance related to Article Matching.

You can always create a new player from your JWP dashboard:

  1. From your dashboard, click Players > CREATE NEW PLAYER.
  2. Replace the default title with a unique player title.
  3. (Optional) Customize the player behaviors and social media sharing options.
  4. Click SAVE.

Is Article Matching supported through WordPress?

Article Matching playlists that are created in your JW Player dashboard can be added to your WordPress content.

To add an Article Matching playlist, use the following steps:

  1. Install the JW Player for WordPress plugin for a cloud-hosted or self-hosted player. Free and Premium options are available.
  2. In the WordPress editor, select the Article Matching playlist from the JW Player for WordPress section.