Skip to main content
Playlists are ordered collections of media items that play back-to-back on your screens. You control the order of items, how long each one displays, and which screens or schedules use each playlist. A playlist can contain any mix of images, videos, and YouTube videos from your media library.

​
Creating a playlist

1

Open the Playlists section

Navigate to Playlists in the dashboard sidebar.
2

Create a new playlist

Click New playlist. Enter a name for the playlist and set a default duration in seconds.
3

Save the playlist

Click Create. The playlist is created and you are taken to the playlist builder.

​
Default duration

When you create a playlist, you set a default_duration in seconds. This value applies to any item in the playlist that does not have its own duration specified. For example, if you set a default duration of 10 seconds, every image without a custom duration will display for 10 seconds before the next item plays.
For video files, the playback duration is determined by the video’s own length, not the playlist default or per-item duration setting.

​
Adding media items to a playlist

1

Open the playlist builder

Select a playlist from the list to open its builder view.
2

Add a media item

Browse your media library and click Add on any item to append it to the playlist.
3

Set an optional duration

After adding an item, you can enter a custom duration_seconds value for that specific item. Leave it blank to use the playlist default duration.

​
Reordering items

Drag and drop items in the playlist builder to change their playback order. The new order takes effect immediately after you save.

​
Updating an item’s duration

You can change the playback duration for any individual item without affecting the rest of the playlist.
1

Find the item in the playlist builder

Open the playlist and locate the item you want to update.
2

Edit the duration

Click the duration field next to the item and enter a new value in seconds.
3

Save

Confirm the change. The updated duration applies the next time the item plays.
Use per-item durations when you want some items — such as promotional images — to display longer than the playlist default while keeping shorter transitions for other content.

​
Assigning a playlist to a screen

You can assign a playlist directly to a screen from the playlist list, or from the screen’s detail page. Direct assignment sets the default playlist for that screen — this is what plays when no schedule or smart rule is active. See Screens for how to assign a playlist from the screen detail view.

​
Deleting a playlist

1

Select the playlist

From the playlists list, open the playlist you want to delete.
2

Delete the playlist

Click Delete and confirm the action.
Deleting a playlist unassigns it from all screens that were using it as their default playlist. It also deletes all schedules that reference the playlist. The media items inside the playlist are not deleted — they remain in your media library.