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

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 <a href="https://en.wikipedia.org/wiki/Association_rule_learning" target="_blank">association rule mining</a> and content similarity of videos. Recommendations playlists are limited to a **maximum of 100 videos**. If the <a href="https://docs.jwplayer.com/platform/docs/vdh-learn-about-recommendations" target="_blank">Recommendations algorithm</a> 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 <a href="https://docs.jwplayer.com/platform/docs/vdh-edit-video-metadata" target="_blank">Edit video metadata</a> to learn how to update the title and description of a video.

<br /> <hr />

## Create a playlist


If you are a developer or have developer resources, you can use the [Management API](πŸ”—ο»Ώ) to create a Recommendations playlist.

<br />

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


<br />

  1. From the <a href="https://dashboard.jwplayer.com/p/playlists" target="_blank">**Playlists**</a> 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**.

<br />


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.

You can now [pair this playlist with a player](πŸ”—ο»Ώ) and create a recommendations experience for your viewers.

<br /> <br />

### 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.

<table> <thead> <tr> <th> Option </th> <th> Description </th> </tr> </thead> <tbody> <tr> <td width="25%"> <strong>Filter by Tags</strong></td> <td width="75%"> Defines tag rules determining which videos can be dynamically added to the playlist <br /><br /> Use these steps to set this filter: <ol> <li>Click <strong>Include</strong> or <strong>Exclude</strong>. The settings options appear.</li> <li>Choose an <strong>Items should match</strong> option: <ul> <li><strong>All</strong> Matches only videos with all specified tags</li> <li><strong>Any</strong>: Matches videos with any of the specified tags</li> </ul> </li> <li>In the search box, type the name of a tag.</li> <li>Select the tag from the listed options.</li> <li>Click <strong>Include Tags</strong> or <strong>Exclude Tags</strong> to close the settings options.</li> <li>(Optional) If you have multiple tags to add, repeat steps 3-5 until all tags have been added.</li> </ol> You can define tags both to <strong>Include</strong> and <strong>Exclude</strong> for a playlist. Read <a href="https://docs.jwplayer.com/platform/docs/vdh-filter-by-tags-explained" target="_blank">Filter by Tags explained</a> to learn how to filter with tags. <br /><br /> <table> <tr> <td style="background-color:#E4EDF3"><strong>NOTE</strong>: To be able to select the videos that are included or excluded from your Recommendations playlist, <a href="https://docs.jwplayer.com/platform/docs/vdh-edit-video-metadata#basic-information" target="_blank">tags</a> must have been added to the metadata of your content.</td> </tr> </table> </td> </tr> <tr> <td> <strong>Filter by Custom Parameters</strong></td> <td> Filter videos using key-value pairs to include or exclude videos <br /><br /> Use these steps to set this filter: <ol> <li>Click <strong>Include</strong> or <strong>Exclude</strong>. The settings options appear.</li> <li>Choose an <strong>Items should match</strong> option: <ul> <li><strong>All</strong> Matches only videos with all specified key-value pairs</li> <li><strong>Any</strong>: Matches videos with any of the specified key-value pairs</li> </ul> <br /> <table> <tr> <td style="background-color:#E4EDF3"><strong>NOTE</strong>: When <strong>All</strong> is selected, only one key can be added. For example, if your key-value pair is <code>country:spain</code> and <strong>All</strong> is selected, your media selection is limited to one value (Spain) defined under the key (country). <br /><br />To include media based on multiple values, select <strong>Any</strong> and define more than one value per key.</td> </tr> </table> </li> <li>In the <strong>Key</strong> textbox, type a key.</li> <li>In the <strong>Value</strong> textbox, type a value.</li> <li>Click <strong>Include Tags</strong> or <strong>Exclude Tags</strong> to close the settings options.</li> <li>(Optional) If you have multiple custom parameters to add, click <strong>+ Add</strong>. Then, repeat steps 3-4 until all custom parameters have been added.</li> </ol> </td> </tr> <tr> <td> <strong>Recency</strong></td> <td> Only includes videos published within a set number of days <br /><br /> Use this step to set this filter: <ol> <li>In the text field, enter a number for the number of days.</li> </ol> </td> </tr> </tbody> </table>

<br /> <br />

### 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.

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.

<br />

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

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