{{ page.title }}

{{ page.description }}

A playlist is a collection of related videos or other media assets (i.e. seasons, live events, etc) that are grouped together in a particular order for playback in a player. The Media module makes it easy to create playlists and add assets to a playlist. After playlists have been created, you can:

For general information about playlists, including best practices and tips for using them effectively, see Introduction to Playlists.

Types of playlists

There are two types of playlists:

There are Video Cloud and OTT variations of both playlist types.

Brightcove recommends that playlists that contain only videos be created as Video Cloud playlists even though OTT playlists can contain only videos. There is no limit to the number of playlists that can be created. The assets that are initially loaded into a playlist in the player is determined by the type of playlist:

Viewing all playlists

To view all the playlists in the account, in the side navigation panel, click All Video Cloud playlists or OTT playlists. All Video Cloud playlists will display all the Video Cloud playlists that have been created. All OTT playlists will display all the OTT playlists AND the Video Cloud playlists that have been ingested to {{ site.product_short }} (Beacon ingest column with a ).

For Video Cloud playlists, the page will display:

For OTT playlists, the page will display:

Creating a playlist

To create a playlist, open the Media module and follow these steps:

  1. In the side navigation panel, click Create playlist. The Create a playlist dialog will open.
  2. Enter a Playlist name.
  3. Click on a Playlist type.
  4. Click Create playlist. The panel will close and reopen.
  5. Click the Overview tab and configure the Overview settings as needed.
    • Language View ({{ site.product_short }} only) - Select a language to enter Overview settings in a localized language
    • Name - Playlist name
    • Title (OTT playlists only) - Playlist title displayed in {{ site.product_short }} apps
    • Reference ID (Video Cloud playlists only) - A unique ID assigned by a publisher to a playlist
    • Description - Playlist description
    • Show Playlist in Sidebar (Video Cloud playlists only) - If checked, the playlist will appear in the sidebar
  6. The playlist panel will contain other settings that can be configured based upon the type of playlist:

Configuring OTT smart playlist settings

If you are creating a OTT smart playlist, click the Smart tab to configure the smart playlist settings. The Parameters section is used to define which assets will appear in the playlist. The following parameters are supported.

All of the parameters (except Content type and title) support these options:

Using multiple parameters

Multiple parameters can be entered by clicking Add a parameter and then entering an additional parameter. By default, multiple parameters will be evaluated using an AND operation. To change how multiple parameters are evaluated, click the selector icon () next to the Parameters heading.

In the following example, all videos that have a Director of Megan Long and are tagged birds will be added to the playlist.

Click Apply to save the changes.

Adding assets to a OTT manual playlist

To add videos to a OTT manual playlist, follow these steps:

  1. In the side navigation panel, click OTT playlists.
  2. Click on a playlist name to open the playlist details.
  3. Click Add content.
  4. Click on assets to select them. Click on the tabs at the top of the dialog to filter by content type. The search field can be used to search for assets.
  5. Click Add. Videos added to a manual playlist will be added to the end of the playlist.

Configuring OTT playlist availability

Playlist availability details can be used to restrict access to OTT playlists based upon date, locations and devices. To view and edit the availability details for a OTT playlist, follow these steps:

  1. Click OTT playlists in the panel navigation.
  2. Click on a playlist name to open the playlist details page.
  3. Click Edit Settings.
  4. Click the Availability tab.

The availability settings are controlled using rule sets. All playlists must have at least one rule set. Rule sets are created to control access to a video based upon:

For information on creating and managing rule sets, see Creating and Managing Rule Sets.

Configuring Video Cloud smart playlist settings

If you are creating a Smart playlist, click the Smart tab to configure the following settings.

Smart playlist parameters

The Parameters section is used to define which videos will appear in the playlist. The following parameters are supported.

The Name, Description and Custom field (Text type) options support these options:

Using multiple parameters

Multiple parameters can be entered by clicking Add a parameter and then entering an additional parameter. By default, multiple parameters will be evaluated using an OR operation. To change how multiple parameters are evaluated, click the selector icon () next to the Parameters heading.

In the following example, all videos that are tagged birds or animals or have a Subject custom field value of Animals will be added to the playlist.

Click Apply to save the changes.

Adding videos to a Video Cloud manual playlist

To add videos to a manual playlist, follow these steps:

  1. In the side navigation panel, click All videos.
  2. Check the boxes next to the videos that should be added to the playlist.
  3. Click More > Add to Playlist at the top of the page.
  4. Select the playlist to add the videos to.
  5. Click Add. Videos added to a manual playlist will be added to the top of the playlist.

Changing the order of videos in a playlist

To change the order of the videos in a playlist, follow the steps based upon the type of playlist you are working with.

Changing the order of videos in a manual playlist

To change the order of the videos in a {{ site.product_short }} manual playlist or a Video Cloud manual playlist, follow these steps.

  1. Open the playlist using one of these methods:
    • Click on the playlist name in the side navigation panel
    • Click All Video Cloud playlists or OTT playlists in the side navigation panel, locate the playlist and click on the playlist name.
  2. Confirm a list of videos in the playlist appears.
  3. Click on a video asset and drag it to its new location in the list.

Changing the order of videos in a smart playlist

  1. If the playlist is displayed in the side navigation panel, click on the playlist and then click the down arrow next to the playlist and click Edit Settings.
  2. If the playlist is not displayed in the sidebar, click All Video Cloud playlists in the side navigation panel, locate the playlist, click on the playlist name and then click Edit Settings.
  3. Select a new Play Order for the playlist.
  4. Click Save.

Smart playlists are created dynamically when the player is loaded from the available video information so the order should always reflect current state. However, the player always gets its info via the Playback API which uses data cached for up to 20 min. Playlists may take that long to refresh and may be behind what the CMS API would show.

Editing playlist settings

To edit the settings for a manual or smart playlist, follow these steps:

  1. If the playlist is displayed in the side navigation panel, click on the playlist and then click the down arrow next to the playlist and click Edit Settings.
  2. If the playlist is not displayed in the sidebar, click All Video Cloud playlists or OTT playlists in the side navigation panel, locate the playlist and click the on the playlist name and then click Edit Settings.
  3. Edit the playlist settings and then click Apply.

Deleting a playlist

To delete a playlist, follow these steps:

  1. Click All Video Cloud playlists or OTT playlists in the side navigation panel.
  2. Click the checkbox next to the playlist to delete.
  3. Click the delete button ().
  4. Click Delete to confirm the deletion.

If the playlist is displayed in the side navigation panel, you can click on the playlist and then click the down arrow next to the playlist and click Delete.

Removing videos from a manual playlist

To remove a video from a manual playlist, follow these steps:

  1. Open the manual playlist using one of these methods:
    • Click on the playlist name in the side navigation panel
    • Click All Video Cloud playlists or OTT playlists in the side navigation panel, locate the playlist and click on the playlist name.
  2. Confirm that the list of videos in the playlist appears.
  3. Click the checkbox next to the asset(s) to remove.
  4. Click Remove Videos > Remove from playlist.

You can also remove a video from a manual playlist by editing the video properties. In the Categorization section, delete the playlist from the Manual Playlists section.