> For the complete documentation index, see [llms.txt](https://kb.mago.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.mago.io/mago-stage/admin-portal/manage-digital-signage-playlists.md).

# Manage Digital Signage playlists

Digital Signage playlists contain reusable media that can be displayed by supported Mago Stage receivers.

A playlist can contain uploaded media, YouTube videos, and supported YouTube playlists.

You need the appropriate Digital Signage permission to create or manage playlists.

### Create a playlist

1. In the Administration Portal, select **Digital Signage**.
2. Select **New Playlist**.
3. Enter a descriptive **Playlist Name**.
4. Optionally enter a description.
5. Select **Create Playlist**.

The new playlist opens after it has been created.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2Ffs6H7fIUfgQwJFzaoBJi%2Fimage.png?alt=media&amp;token=c28c0b07-d857-4855-877a-999a331921ae" alt=""><figcaption></figcaption></figure>

### Add uploaded media

1. Open the required playlist.
2. Select **Add media**.
3. Select **Upload File**.
4. Optionally enter a slide title.
5. Select **Choose File** and select the media file.
6. Configure the available timing option.
7. Select **Add Slide**.

For PDF files, the page-advance value controls how long each page remains visible before advancing to the next page.

The portal validates whether the selected file is supported.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2FXXV5Dgt9248GrUqhBR4g%2Fimage.png?alt=media&amp;token=9930b328-2a3f-46fe-a0d6-bd94c9b80dbf" alt=""><figcaption></figcaption></figure>

### Add a YouTube video

1. Open the required playlist.
2. Select **Add media**.
3. Select **YouTube URL**.
4. Optionally enter a slide title.
5. Paste the YouTube video URL.
6. Configure the duration when the option is available.
7. Select **Add YouTube**.

YouTube playback requires access to the applicable external YouTube services. For network requirements, see **Third-party service endpoints**.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2FW3OZpvJnnbEUgdwbHtlK%2Fimage.png?alt=media&amp;token=37a3c9a3-e097-409b-98b8-95f45325755b" alt=""><figcaption></figcaption></figure>

### Add a YouTube playlist

1. Open the required Mago Stage playlist.
2. Select **Add media**.
3. Select **YouTube URL**.
4. Paste the YouTube playlist URL.
5. Select **Add YouTube**.

Mago Stage adds the videos from the YouTube playlist and skips videos that already exist in the Mago Stage playlist.

{% hint style="info" %}
Changes made later to the original YouTube playlist might not automatically update items that have already been added to Mago Stage.
{% endhint %}

### Reorder playlist items

1. Open the playlist.
2. Find the item that you want to move.
3. Drag the item using its reorder handle.
4. Drop it in the required position.

The order shown in the playlist determines the playback order.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2FRVRYEVWd4b0k3ABH6Kni%2Fimage.png?alt=media&amp;token=9c53f500-c0fe-43ca-ad9b-8457425e4637" alt=""><figcaption></figcaption></figure>

### Edit a playlist item

Depending on the media type, you can:

* Change the displayed title
* Change the slide duration
* Change PDF page-advance timing
* Download uploaded media when available

Open the item’s available controls, make the required changes, and save them.

### Remove a playlist item

1. Open the playlist.
2. Find the item that you want to remove.
3. Select the delete icon.
4. Confirm the action when prompted.

Removing an item does not delete the entire playlist.

### Rename a playlist

1. Open the playlist.
2. Open the playlist actions menu.
3. Select the rename or edit action.
4. Change the playlist name or description.
5. Save the changes.

### Delete a playlist

1. Open the playlist.
2. Open the playlist actions menu.
3. Select **Delete**.
4. Confirm the deletion.

{% hint style="danger" %}
Deleting a playlist permanently removes the playlist and its item associations. Confirm that it is not required by an active Digital Signage configuration before deleting it.
{% endhint %}

### Use a playlist

After creating and reviewing the playlist, select it in the appropriate Digital Signage policy.

For instructions on configuring and assigning policies, see:

* **Manage policies**
* **Display-based assignments**
* **Tag-based assignments**
