Creating and Managing Playlists

A playlist is a collection of videos that are grouped together in a particular order for playback in a player. The Media module makes it easy to create playlists and add videos to a playlist. After you've created your playlist, you can publish a playlist to a player. For more information on publishing playlists, see Publishing Videos and Playlists with the Media Module.

For more 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:

• Manual - With a manual playlist, you assign specific videos to the playlist and re-order them manually
• Smart - With a smart playlist, the videos in the playlist are constructed automatically, based on video parameters. Parameters include name, tags, description, custom fields and date fields. Smart playlists are dynamic and automatically update based upon the videos in your media library and the rules that define the playlist.

A maximum of 1,000 videos can be added to a playlist (both Manual and Smart). There is no limit to the number of playlists that can be created. The videos that are initially loaded into a playlist in the player is determined by the type of playlist:

• Manual Playlists - Videos are loaded into the playlist based upon the order of the videos in the playlist
• Smart Playlists - Videos are loaded into the playlist based upon the Play Order playlist setting

For information on programmatically retrieving additional videos into a playlist, see the Playback API Paging player sample.

Viewing all playlists

To view all the playlists in the account, open the Media module and click the Playlists tab at the top of the page. The list displays:

• Name - Name of the playlist
• Type - Manual or Smart playlist
• Playlist ID - System-assigned playlist ID
• Reference ID - Reference ID for the playlist
• Parameters - Parameters used to create the playlist (smart playlists only)

Creating a playlist

To create a playlist, follow these steps:

1. Open the Media module.
2. In the Media toolbar, click New and select New Playlist. The Create a playlist dialog opens.
3. Enter a Playlist name.
4. Click Manual playlist or Smart playlist to select the type.
5. Click Create playlist. The playlist opens on the Playlists tab. For smart playlists, configure the smart playlist parameters.
6. Configure the playlist settings from the details panel:
   • Name - Playlist name
   • Reference ID - A unique ID assigned by a publisher to a playlist
   • Description - Playlist description

Configuring smart playlist settings

For a Smart playlist, open the Playlist settings modal from the playlist details panel. The Video Order tab contains the playback order, video limit, and parameter rules.

• Play Order - Controls the order in which videos in the playlist are played. The following options are available.

  Play Order	Description
  Activated Date (Oldest First)	Based on the date the video was activated, oldest videos first
  Activated Date (Newest First)	Based on the date the video was activated, newest videos first
  Video Name (A - Z)	Alphabetical by video name
  Total Plays	Based on the total video plays
  Trailing Week Plays	Based on the trailing week total video plays. Note that the trailing week plays data maintained in the video metadata may be up to 2 days old so the videos you get may not match what you see if you look at video views over the past 7 days in the Analytics module.
  Start Date (Oldest First)	Based on the date the video was scheduled to start, oldest videos first. If a video does not have a start date specified, then it will not appear in a playlist ordered by start date. Note: Video scheduling is available only to Video Cloud Enterprise accounts.
  Start Date (Newest First)	Based on the date the video was scheduled to start, newest videos first. If a video does not have a start date specified, then it will not appear in a playlist ordered by start date. Note: Video scheduling is available only to Video Cloud Enterprise accounts.

• Limit Number of Videos - Enter the maximum number of videos that should be in the playlist (default is 100, maximum is 1,000)

Smart playlist parameters

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

• Tags - Video tags are used to define the videos that will appear in the playlist. Enter one or more tags (separated by commas). The Tags dropdown provides these options:
  • Match any - Include videos that have one or more of the tags listed
  • Match all - Require that all the videos in the playlist have all the tags that are listed
• Name - The video name is used to define the videos that will appear in the playlist. Enter a video name to search for.
• Description - The video's short and long description are used to define the videos that will appear in the playlist. Enter a description to search for.
• Custom fields - The video's custom fields are used to define the videos that will appear in the playlist. Select a custom field from the dropdown list and then select/enter a custom field value. For List type custom fields:
  • Match any - Include videos that have any of the custom field values listed
  • Exclude - Exclude videos with the selected custom field values listed
• Updated date - The date the video was last updated
• Created date - The date the video was created
• Last activated date - The date the video was last activated
• Scheduled start date - The date the video was scheduled to start
• Scheduled end date - The date the video was scheduled to end

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

• Text to include - Include videos that have the text in the name, short or long description or custom field
• Text to exclude - Exclude videos that have the text in the name, short or long description fields or custom field

All of the date parameters support a From and To date.

To add a parameter, click + New Parameter and choose a parameter type from the dropdown.

Using multiple parameters

To control how multiple parameters are evaluated, use the dropdown next to the Parameters heading and select Match all parameters (AND) or Match any parameter (OR). The example below shows a Tags parameter set to match any:

Click Save to apply the changes.

Adding videos to a manual playlist

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

1. On the Videos tab, select the checkboxes next to the videos that should be added to the playlist.
2. On the bulk-action bar, click Add to playlist.
3. Select the playlist to add the videos to.
4. 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.

Editing playlist settings

To edit the settings for a manual or smart playlist:

1. On the Playlists tab, click the playlist name to open the playlist details.
2. Edit the playlist settings and click Apply.

Deleting a playlist

To delete a playlist:

1. On the Playlists tab, select the checkbox next to the playlist to delete. The bulk-action bar appears at the bottom of the page.
2. On the bulk-action bar, click Delete.
3. Click Delete Playlist to confirm.

Removing videos from a manual playlist

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

1. On the Playlists tab, click the manual playlist name to open its video list.
2. Select the checkbox next to the video(s) you want to remove.
3. Click Remove from Playlist.

You can also remove a video from a manual playlist by opening the video details page, expanding the Information accordion on the Overview tab, and removing the playlist from the Playlists field.