Create a Recommendations playlist

<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 />
From the <a href="https://dashboard.jwplayer.com/p/playlists" target="_blank">**Playlists**</a> page, click **Create Playlist**. A popup window appears.
Click the **Recommendations** tile. The **Configuration** tab of the playlist settings appears.
Replace _Untitled Recommendations Playlist_ with a title for the playlist.
(Optional) Set the [video filters and recency](🔗﻿).
(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.
(Optional) Enable [**Promoted Content**](🔗﻿).
In the **Preview** section, under **Source Media**, click **+ Add Source Media**. The **Add Source Media** panel appears. 
At the top of the **Add Source Media** panel, search and filter to find specific media or select any media visible in the list.
Select a media item. The panel closes. The **Preview** section updates to show the **Source Media** and **Top Recommendations results**. 
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:
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:
In the **Promoted Content** section, click the toggle to **ON**. The settings appear.
From the **Content in Position 1** dropdown menu, select a playlist.
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>