Create a Recommendations playlist

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

🔑

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

Follow these steps to create a dynamic playlist:

1. From the Playlists page, click Create playlist > Recommendation. The Settings tab appears.
2. Under Title, rename the playlist. Though not required, giving a playlist a unique name allows it to be quickly distinguished from other playlists.
3. (Optional) Specify the content to display.
4. (Optional) Enter the maximum number of videos to display per page in the playlist.
5. (Optional) Promote videos by pinning content to a playlist position.
6. In the Preview section, under Source media, click + Add source media. The Add source media panel appears.
7. At the top of the panel, search and filter to find specific media or select any media visible in the list.
8. Select a media item. The panel closes. The Preview section updates to show the Source media and Top recommendations results.
9. Click Save.

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

Filters

Option	Description
Tags	Defines tag rules determining which videos can be dynamically added to the playlist Use these steps to set this filter: Click Include or Exclude. The settings options appear. Choose an Items should match option: All Matches only videos with all specified tags Any: Matches videos with any of the specified tags In the search box, type the name of a tag. Select the tag from the listed options. Click Include Tags or Exclude Tags to close the settings options. (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. 📘 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.
Custom parameters	Filter videos using key-value pairs to include or exclude videos Use these steps to set this filter: Click Include or Exclude. The settings options appear. 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 📘 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. In the Key textbox, type a key. In the Value textbox, type a value. Click Include Tags or Exclude Tags to close the settings options. (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

⤴️ Return to step 4 of the main process.

Content preferences

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.

⤴️ Return to step 5 of the main process.

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. Only manual playlists can be selected.

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 manual playlist or None.
3. From the Content in Position 2 dropdown menu, select an existing manual playlist or None.

⤴️ Return to step 6 of the main process.