Create a dynamic playlist

Dynamic playlists automatically include or exclude videos that match content filtering rules set and are sorted by fields, such as publish date, duration, and play count.

🔑

If you are a developer or have developer resources, you can use the Management API to create a dynamic 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.

Follow these steps to create a dynamic playlist:

1. From the Playlists page, click Create playlist. A popup window appears.
2. Click the Dynamic title. The playlist settings page appears.
3. Under Title, rename the playlist. Though not required, giving a playlist a unique name allows it to be quickly distinguished from other playlists.
4. (Optional) Add playlist metadata.
5. (Optional) Specify the content to display and its display order.
6. (Optional) Enter the maximum number of videos to display per page in the playlist.
7. (Optional) Promote videos by pinning content to a playlist position.
8. Click Save.

You can now click Embed to pair this playlist with a player and embed the pair on a webpage.

Playlist metadata

Setting	Description
Description	Used for SEO and are searchable via the JWP dashboard and Platform API
Custom Parameters	Key-value pairs used to inject custom parameters into the playlist Playlist custom parameters will appear in the delivery response at the top level (JSON or RSS). Follow these steps to define custom parameters: In the Key textbox, enter a key. In the Value textbox, enter a value. To add more custom parameters, click + Add and repeat steps 1-2
Playlist Page Permalink	If defined, used as the sharing link instead of the content server URL

Sort and filter

📘

To be able to select the videos that are included or excluded from your dynamic playlist, tags must have been added to the metadata of your content.

Setting	Description
Sort by	Controls the order of the media Follow these steps to configure this setting: From the Sort by dropdown menu, choose the sort order. Click the arrows to arrange the media in ascending or descending sort order. Possible Sort Types: Publish Date (default): Date that the media items were published Duration: Duration of the media items Plays: Lifetime number of times the media items have been played Title: First letter of the media title Trending: Most popular videos, based on play count. Uses an Exponentially Weighted Moving Average (EWMA) score to rate recent plays over a period of 6 hours and is limited to a maximum of 500 videos. Periodically updates based on play performance. Shuffle: Randomizes the order of videos with every un-cached playlist request.
Filter by Tags	Defines tag rules that determine which videos can be dynamically added to the playlist Follow these steps to configure this setting: Click Include Tags or Exclude Tags. The settings options appear. Choose one of the Items should match radio buttons: All (to include or exclude only videos with all specified tags) Any (to include or exclude videos with any of the specified tags) In the search box, search for the name of the tag. Select the tag from the listed options. Click Add.If you have multiple tags to add, repeat steps 3-5 until all tags have been added.You can define both Include Tags and Exclude Tags for a playlist. Read Filter by Tags explained to learn how to filter with tags.
Filter by Custom Parameters	Filter videos using key-value pairs to include or exclude videos Follow these steps to configure this setting: Click Include Parameters or Exclude Parameters. The settings options appear. Choose one of the Items should match radio buttons: All (to include or exclude only videos with all matching key-value pairs) Any (to include or exclude only videos with any of the specified key-value pairs). In the Key textbox, enter a key. In the Value textbox, 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. 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.
Recency	Only includes 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. 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.