Create an Article Matching playlist

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.

---

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.

Use the following steps to create an Article Matching playlist:

1. From the Playlists 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.

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.

Filter by Tags

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

1. Click Include or Exclude. The settings options appears.
2. Choose one of the Items should match radio buttons:
   • All: Include or exclude only videos with all specified tags
   • Any: Include or exclude videos with any of the specified tags
3. In the search box, search for the name of the tag.
4. Select the tag from the listed options.

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

💡

You can filter by both included and excluded tags. Learn more about filtering by tags.

Filter by Custom Parameters

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

1. Click Include or Exclude. The settings options appears.
2. Choose one of the Items should match radio buttons:
   • All: Include or exclude only videos with all specified key-value pairs.
   • Any: Include or exclude videos with any of the specified key-value pairs.
3. In the Key box, enter a key.
4. In the Value box, enter a value.

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

Recency

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

Items Per Page

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.

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.

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.