---
updatedAt: 2026-09-10T15:03:44.000Z
agentTools:
  siteIndex: https://docs.jwplayer.com/llms.txt
  projectIndex: https://docs.jwplayer.com/platform/llms.txt
---

# Media Curation

Learn how to define a Dynamic Strategy Rules media curation configuration

A media curation configuration allows you to select and curate media and playlists.

<br />

***

## Define a media curation configuration

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/3f981d94ad6a816fe4a309575d457ae5fd306ae37c4c88ec36ea92227d108b7d-dsr-media-curation.png",
        "",
        "Create media curation page"
      ],
      "align": "center",
      "sizing": "90% ",
      "border": true,
      "caption": "Create media curation page"
    }
  ]
}
[/block]

<br />

Follow these steps to define a media curation configuration:

1. On the **Library** tab, click **Create library > Media curation**. The **Create media curation** page appears.
2. Under **Media curation**, enter a **Name**. This will identify the media curation configuration on the **Library** tab.
3. On the **Playlist** tab, select the content to play.
   <details><summary><strong>Single media</strong></summary>
       <br />
       Follow these steps to define a single media:
       <ol>
           <li>For the <strong>Type</strong>, choose <strong>Single media</strong>.</li>
           <li>From the dropdown menu, select a media item.</li>
           <li>(Optional) Select <strong>Use Key for media if available</strong>. From the dropdown, select the key for <a href="https://docs.jwplayer.com/platform/docs/provide-custom-data-to-a-placement">custom data</a>.
               <br /><br />
               <strong>NOTE</strong>: If the key you need does not exist, <a href="https://docs.jwplayer.com/platform/docs/create-and-manage-key-value-pairs-kvps">add the key</a>.<br />
           </li>
       </ol>
       <br />
   </details>
   <details><summary><strong>Playlist</strong></summary>
       <br />
       Follow these steps to define a playlist:
       <ol>
           <li>For the <strong>Type</strong>, choose <strong>Playlist</strong>.</li>
           <li>From the dropdown menu, select a playlist.</li>
           <li>(Optional) Select <strong>Use Key for playlist if available</strong>. From the dropdown, select the key for <a href="https://docs.jwplayer.com/platform/docs/provide-custom-data-to-a-placement">custom data</a>.
               <br /><br />
               <strong>NOTE</strong>: If the key you need does not exist, <a href="https://docs.jwplayer.com/platform/docs/create-and-manage-key-value-pairs-kvps">add the key</a>.<br />
           </li>
       </ol>
       <br />
   </details>
   <details><summary><strong>Playlist URL</strong></summary>
       <br />
       Follow these steps to define a playlist URL:
       <ol>
           <li>For the <strong>Type</strong>, choose <strong>Playlist URL</strong>.</li>
           <li>In the text field, enter the URL for a playlist.</li>
           <li>From the dropdown, select the key for <a href="https://docs.jwplayer.com/platform/docs/provide-custom-data-to-a-placement">custom data</a>.
               <br /><br />
               <strong>NOTE</strong>: If the key you need does not exist, <a href="https://docs.jwplayer.com/platform/docs/create-and-manage-key-value-pairs-kvps">add the key</a>.<br />
           </li>
       </ol>
       <br />
   </details><br />
4. (Optional) Enable [recommendations](#recommendations)  to increase viewer engagement.
5. <a id="step5"></a>(Optional) On the **Advanced curation (optional)** tab, curate videos by pinning media to a playlist position.
   <details><summary><strong>Single media</strong></summary>
       <br />
       Follow these steps to curate a single media:
       <ol>
           <li>For the <strong>Type</strong>, choose <strong>Single media</strong>.</li>
           <li>Choose the media to display through one of the following approaches:
               <ul>
                   <li>Select <strong>Use Key for media if available</strong>. From the dropdown, select the key for <a href="https://docs.jwplayer.com/platform/docs/provide-custom-data-to-a-placement">custom data</a>.
                       <br /><br />
                       <strong>NOTE</strong>: If the key you need does not exist, <a href="https://docs.jwplayer.com/platform/docs/create-and-manage-key-value-pairs-kvps">add the key</a>.<br />
                   </li>
                   <li>From the <strong>Select Media</strong> dropdown menu, select a media item.</li>
               </ul>
           </li>
           <li>To curate more content, click <strong>+ Subsequent play</strong> and repeat steps <strong>i-ii</strong>.</li>
       </ol>
       <br />
   </details>
   <details><summary><strong>Playlist</strong></summary>
       <br />
       Follow these steps to curate a playlist:
       <ol>
           <li>For the <strong>Type</strong>, choose <strong>Playlist</strong>.</li>
           <li>Choose the media to display through one of the following approaches:
               <ul>
                   <li>Select <strong>Use Key for playlist if available</strong>. From the dropdown, select the key for <a href="https://docs.jwplayer.com/platform/docs/provide-custom-data-to-a-placement">custom data</a>.
                       <br /><br />
                       <strong>NOTE</strong>: If the key you need does not exist, <a href="https://docs.jwplayer.com/platform/docs/create-and-manage-key-value-pairs-kvps">add the key</a>.<br />
                   </li>
                   <li>From the <strong>Select Media</strong> dropdown menu, select a playlist.</li>
               </ul>
           </li>
           <li>To curate more content, click <strong>+ Subsequent play</strong> and repeat steps <strong>i-ii</strong>.</li>
       </ol>
       <br />
   </details>
   <details><summary><strong>None</strong> (default)</summary>
       <br />
       Follow this step to not curate a video for a specific playlist position:
       <ol>
           <li>For the <strong>Type</strong>, choose <strong>None</strong>.</li>
       </ol>
       <br />
   </details><br />
6. (Optional) Refine the configuration with the [JSON Editor](#json-editor).
7. <a id="step7"></a>Click **Save**. The media curation library will appear on the **Library** tab.

<br />

### Recommendations

Recommendations automate the generation of a playlist based on the currently-watched video and provide you options to customize the appearance and behavior of that playlist.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/7399b1dab3641b4a05f96d44d60f2b0db1e4d6e4584dadbd948c2318f08a5431-dsr-media-curation-recommendations.png",
        "",
        "Recommendations tab"
      ],
      "align": "center",
      "sizing": "60% ",
      "border": true,
      "caption": "Recommendations tab"
    }
  ]
}
[/block]

<br />

Follow these steps to set up recommendations:

1. On the **Recommendations** tab, click the **Show recommendations** toggle to turn **ON**.

2. From the **Recommendations playlist** dropdown menu, select a playlist.

3. Optional) Click the <strong>Use Key for playlist if available</strong> checkbox. From the dropdown, select the key for <a href="https://docs.jwplayer.com/platform/docs/provide-custom-data-to-a-placement">custom data</a>.

   <Callout icon="💡" theme="default">
     If the key you need does not exist, [add the key](https://docs.jwplayer.com/platform/docs/create-and-manage-key-value-pairs-kvps).
   </Callout>

4. (Optional) From the **Auto-advance to next video after** dropdown menu, choose when to autoplay the next video

5. (Optional) Click the **Display Custom Text** checkbox and enter a message.

   <Callout icon="📘" theme="info">
     Read the <a href="/platform/docs/players-set-up-recommendations#countdown-overlay" target="_blank">Countdown Overlay</a> section to learn more about this message.
   </Callout>

6. (Optional) Update the **Display title**. By default, *More Videos* is used.

7. (Optional) Select the **Display mode**.

<br />
⤴️ <a href="#step5">Return to step <strong>5</strong> of the main process.</a>

<br /><br />

### JSON Editor

The **JSON Editor** lets you view and customize configurations beyond the standard dashboard settings:

* View the full configuration structure
* Modify supported fields not exposed in the dashboard
* Apply precise adjustments for advanced scenarios

<br />

<Callout icon="🚧" theme="warn">
  Use the JSON Editor only if you understand structured configuration data and how changes affect strategy behavior. In most cases, configure settings using the standard dashboard fields.
</Callout>

<br />

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/786f03a19c42ac0bfcf87d4d8dbf05aecb5e6439c2a73005a89c1ccd9f813221-dsr-json-editor-media-curation.png",
        "",
        "Edit Media Curation Configuration panel"
      ],
      "align": "center",
      "sizing": "70% ",
      "border": true,
      "caption": "Edit Media Curation Configuration panel"
    }
  ]
}
[/block]

<br />

Follow these steps to use the editor:

1. Click **JSON Editor**. The **Edit Media Curation Configuration** panel opens.

2. Edit the JSON.

   <Callout icon="💡" theme="default">
     Use the following references for updating the JSON code for a media curation configuration.

     **Playlist**:

     - <a href="https://docs.jwplayer.com/players/reference/playlists" target="_blank">playlists</a>

     **Recommendations**:

     - <a href="https://docs.jwplayer.com/players/reference/related-config-ref" target="_blank">related</a>
     - <a href="https://docs.jwplayer.com/players/reference/internationalization#intllangrelated-object" target="_blank">intl.{lang}.related</a>
   </Callout>

3. Click **Done**. The configuration updates, and the panel closes.

<br />
⤴️ <a href="#step7">Return to step <strong>7</strong> of the main process.</a>

<br /><hr />

## FAQ

<details><summary><strong>In Dynamic Strategy Rules, can a media item be dynamically set with key-value pairs?</strong></summary>

<a id="dynamic-tag"></a>

Yes. Read [Set a media item via a key-value pair](https://docs.jwplayer.com/platform/docs/set-a-media-item-via-a-key-value-pair) for more information.

</details>

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

# Sub pages

* [Set a media item via a key-value pair](https://docs.jwplayer.com/platform/docs/set-a-media-item-via-a-key-value-pair.md)

# Sibling pages

* [Advertising](https://docs.jwplayer.com/platform/docs/dsr-advertising.md)
* [Player UX](https://docs.jwplayer.com/platform/docs/player-ux.md)
* [Partnership](https://docs.jwplayer.com/platform/docs/partnership.md)
* [Max RPM configuration](https://docs.jwplayer.com/platform/docs/max-rpm-configuration.md)
* [Manage a configuration](https://docs.jwplayer.com/platform/docs/manage-a-configuration.md)