Working with Playlists in Theme Builder

You can create and customize as many playlists as you like.

Playlists are ordered groupings of video content. The video content you include in playlists must be completely transcoded. You can build playlists by specific video assets or by label.
Note:
  • The maximum number of videos you can add to a playlist is 64.
  • The maximum number of labels you can associate with a playlist is 16.
  • Allow some time for the playlist you create to be propagated through the Ooyala systems. If you are doing a demonstration, it is best to use playlists you have created previously.

With playlists you can control the content your viewers can access within a theme. You can also organize the content in the playlist. For example, you can create a western theme and fill it with a playlist of western movies ordered by release date.

To create, update, or delete a playlist:

  1. Log in to Theme Builder.
  2. Click the Playlists tab.
  3. At the lower left, click the + button. The Add New Playlist dialog box appears.
  4. Enter a title for the playlist, choose whether you will select videos manually or build the playlist based on labels, and click Add. The new playlist is created.
  5. If you chose to build your playlist by manually selecting videos, you can begin adding videos.
    1. To add a video, use the Search box.
      In the Search text box, enter a search string to match against the title, description, or metadata of videos, and hit Enter. The following restrictions apply:
      • The search is not case-sensitive.
      • The search string must be at least 3 characters long.
      • The special characters $ and ^ must be escaped with a backslash, like this: \$ or \^.
      • To search for partial (rather than exact) strings in either titles or descriptions (but not in metadata), you can use the * wildcard character. For example, the string Jim* matches videos with titles or description containing Jim1, JimJam, or Jim99, but it does not match a video with the title JamJim. To match JamJim, you can use Jam* or *Jim.
      Matching videos are listed.
    2. To add a video to the playlist, click the plus sign to the left of the video preview.
    3. Continue searching for videos and clicking their plus signs until you have added all videos that you want in the playlist.
    4. From the Order by list box, select how videos should be ordered in the playlist.
    5. To customize the order in which videos appear, drag them to the desired locations.
  6. If you chose to build your playlist from labels, you can begin specifying labels. For best practices when using labels see Best Practices for Labels.
    1. Select whether videos must have all or any of the specified labels you specify.
    2. Click Select and then choose the labels you want to use.

      You must specifically select all the labels you want, including any "child" labels of top-level "parent" labels. Such "child" labels are not selected automatically. For example, the screenshot below shows three levels of label.

      The first and second level labels (sports and baseball) have been selected, but the third level (giants) has not been selected. It will not be used in the selection of videos.

      Likewise, you must manually deselect any child or parent labels you do not want to include.

    3. Select how videos are ordered in the playlist from the Order by list box.
    4. To display all videos that match, select Show all. To limit the results, select Only show the first and specify the maximum number of videos to list. Matching videos are listed.
  7. When you are finished, click Publish to publish your changes. To discard your changes, click Revert.
    Note: When you click Publish, your changes are saved. In addition, if you have previously embedded this playlist or player (that is, if you have previously published it), the saved changes become visible.
  8. To add videos to a previously created playlist:
    1. From the list of playlists on the left, select the desired playlist.
    2. If you have previously added videos to this playlist, select how videos are ordered in the playlist from the Order by list box.
    3. In the upper area, click Add Videos to Playlist.
    4. Make your desired changes.
    5. When you are finished, click Publish to publish your changes. To discard your changes, click Revert.
  9. To duplicate, rename, or delete a playlist:
    1. From the list of playlists on the left, select the desired playlist.
    2. Click the gear symbol to the right of the playlist name.
    3. From the menu, select the desired operation and confirm it.

Was this article helpful?