<img src="https://img.shields.io/badge/%20-ENTERPRISE-%23B10031" style="float:left"/><br />

An Article Matching playlist inserts contextually relevant videos into your articles. Article Matching playlists are limited to a **maximum of 100 videos**.



If you are a developer or have developer resources, you can use the [Management API](🔗) to create an Article Matching playlist.

<br /> <hr />

## Create a playlist



When updates are made to playlists, there may be up to 3 minutes of caching in JWP's systems before the changes are reflected. Web browsers also cache playlist content and can be cleared.

<br />

Article Matching playlist preview


Article Matching playlist preview

<br />

Use the following steps to create an Article Matching playlist:

  1. From the <a href="https://dashboard.jwplayer.com/p/playlists" target="_blank"><strong>Playlists</strong></a> page, click **Create Playlist**. A popup window appears.

  2. Click the **Article Matching** tile. The playlist settings page appears.

  3. Click the default name (_Untitled Article Matching Playlist_) to rename the playlist. Though not required, giving a playlist a unique name allows it to be quickly distinguished from other playlists.

  4. (Optional) Define [filters](🔗) that determine which videos appear in the playlist.

  5. (Optional) Set the number of [items to display](🔗) in a playlist.

  6. (Optional) Select [content to promote](🔗).

  7. Click **Save**.

You can now [Embed contextually relevant videos](🔗) with the content on your page.

<br /><br />

### Filters

JWP provides three ways to filter playlist content: [Filter by Tags](🔗), [Filter by Customer Parameters](🔗), and [Recency](🔗). These filters can be used individually or in combination. The following sections explain each filter type.

<br />

#### Filter by Tags

Filter by Tags section


Filter by Tags section

Use the following steps to define tag rules that determine which videos to **Include** in or **Exclude** from the playlist.

<ol> <li>Click <strong>Include</strong> or <strong>Exclude</strong>. The settings options appears.</li> <li>Choose one of the <strong>Items should match</strong> radio buttons: <ul> <li><strong>All</strong>: Include or exclude only videos with all specified tags</li> <li><strong>Any</strong>: Include or exclude videos with any of the specified tags</li> </ul> </li> <li>In the search box, search for the name of the tag.</li> <li>Select the tag from the listed options.</li> </ol>

If you have multiple tags to add, repeat steps 3-4 until all tags have been added.

<br />



You can filter by both included and excluded tags. Learn more about <a href="https://docs.jwplayer.com/platform/docs/vdh-filter-by-tags-explained" target="_blank">filtering by tags</a>.

<br /><br />

#### Filter by Custom Parameters

Filter by Custom Parameters section


Filter by Custom Parameters section

Use the following steps to define custom parameter (key-value pair) rules that determine which videos to **Include** in or **Exclude** from the playlist:

<ol> <li>Click <strong>Include</strong> or <strong>Exclude</strong>. The settings options appears.</li> <li>Choose one of the <strong>Items should match</strong> radio buttons: <ul> <li><strong>All</strong>: Include or exclude only videos with all specified key-value pairs.</li> <li><strong>Any</strong>: Include or exclude videos with any of the specified key-value pairs.</li> </ul> </li> <li>In the <strong>Key</strong> box, enter a key.</li> <li>In the <strong>Value</strong> box, enter a value.</li> </ol>

If you have multiple custom parameters to add, click **+ Add** and repeat steps 3-4 until all custom parameters have been added.

<br /><br />

#### Recency

Receny section


Recency section

In the textbox, enter the a number to only include videos published within a set number of days.

<br /><br /><br />

### Items Per Page

Items Per Page section


Items Per Page section

In the textbox, enter the maximum number of videos to display in the playlist. If no number is entered, the list length will default to 10 videos.

<br /><br /><br />

### Promoted Content

The **Promoted Content** setting allows you to promote videos by pinning content to a playlist position. If the selected playlist has more than one video, a random video is selected each time.

Promoted Content setting


Promoted Content setting

Use the following steps to promote videos in position 1, position 2, or both:

  1. Click the **Promoted Content** toggle to **ON**. The **Promoted Content** settings appear.

  2. From the **Content in position 1** dropdown menu, select an existing playlist or **None**.

  3. From the **Content in position 2** dropdown menu, select an existing playlist or **None**.

<br />

<!-- Removes the automatic page-to-page navigation at the bottom of the page -->

<style> .rm-Pagination { display: none; } </style>