Create a Recommendations playlist

Learn how to use a video to automatically suggest videos with the highest likelihood to extend a viewer's watch session.


A Recommendations playlist suggests videos based on the first video that a viewer watches. These videos are based on an aggregated data set across all users and are not specific to a single user.

Recommendations are selected by using a blend of two proprietary methodologies: a version of association rule mining and content similarity of videos. Recommendations playlists are limited to a maximum of 100 videos. If the Recommendations algorithm cannot find any videos using the methodologies above, trending videos are served

šŸš§

For meaningful recommendations to be shown to viewers, create descriptive, keyword-rich titles and descriptions for the videos in your media library. Read Edit video metadata to learn how to update the title and description of a video.



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.

šŸ”‘

If you are a developer or have developer resources, you can use the Management API to create a Recommendations playlist.


Use the following video and steps to create a Recommendations playlist.


  1. From the Playlists page, click Create Playlist. A popup window appears.
  2. Click the Recommendations tile. The Configuration tab of the playlist settings appears.
  3. Replace Untitled Recommendations Playlist with a title for the playlist.
  4. (Optional) Set the video filters and recency.
  5. (Optional) In the Items Per Page section, enter the maximum number of videos to display in the playlist.

    šŸ“˜

    If no number is entered, the list length will default to 10 videos.

  6. (Optional) Enable Promoted Content.
  7. In the Preview section, under Source Media, click + Add Source Media. The Add Source Media panel appears.
  8. At the top of the Add Source Media panel, search and filter to find specific media or select any media visible in the list.
  9. Select a media item. The panel closes. The Preview section updates to show the Source Media and Top Recommendations results.
  10. Click SAVE.

You can now pair this playlist with a player and create a recommendations experience for your viewers.



Set video filters

Use the following step to configure the video filters:

  1. On the Configuration tab, in the Filters section, configure the filters. The following table explains each filter option.
Option Description
Filter by Tags Defines tag rules determining which videos can be dynamically added to the playlist

Use these steps to set this filter:
  1. Click Include or Exclude. The settings options appear.
  2. Choose an Items should match option:
    • All Matches only videos with all specified tags
    • Any: Matches videos with any of the specified tags
  3. In the search box, type the name of a tag.
  4. Select the tag from the listed options.
  5. Click Include Tags or Exclude Tags to close the settings options.
  6. (Optional) If you have multiple tags to add, repeat steps 3-5 until all tags have been added.
You can define tags both to Include and Exclude for a playlist. Read Filter by Tags explained to learn how to filter with tags.

NOTE: To be able to select the videos that are included or excluded from your Recommendations playlist, tags must have been added to the metadata of your content.
Filter by Custom Parameters Filter videos using key-value pairs to include or exclude videos

Use these steps to set this filter:
  1. Click Include or Exclude. The settings options appear.
  2. Choose an Items should match option:
    • All Matches only videos with all specified key-value pairs
    • Any: Matches videos with any of the specified key-value pairs

    NOTE: When All is selected, only one key can be added. For example, if your key-value pair is country:spain and All is selected, your media selection is limited to one value (Spain) defined under the key (country).

    To include media based on multiple values, select Any and define more than one value per key.
  3. In the Key textbox, type a key.
  4. In the Value textbox, type a value.
  5. Click Include Tags or Exclude Tags to close the settings options.
  6. (Optional) If you have multiple custom parameters to add, click + Add. Then, repeat steps 3-4 until all custom parameters have been added.
Recency Only includes videos published within a set number of days

Use this step to set this filter:
  1. In the text field, enter a number for the number of days.


Enable Promoted Content

In the Promoted Content section, you can highlight 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 videos will not be visible in the Preview panel.


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

  1. In the Promoted Content section, click the toggle to ON. The settings appear.
  2. From the Content in Position 1 dropdown menu, select a playlist.
  3. From the Content in Position 2 dropdown menu, select a playlist.