> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeonbot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Playlists

> Create and manage your own personal saved playlists.

The Playlist system allows you to save up to **25 personal playlists**, each holding a maximum of **500 tracks**. Your playlists are tied to your Discord account, meaning you can load your saved music in any server that uses ZEON.

***

## Managing Playlists

| Command                        | Description                                                               |
| :----------------------------- | :------------------------------------------------------------------------ |
| `.playlist create <name>`      | Creates a new empty playlist.                                             |
| `.playlist list`               | Shows all of your saved playlists and how many tracks they contain.       |
| `.playlist rename <old> <new>` | Renames an existing playlist.                                             |
| `.playlist info <name>`        | Displays details about a playlist (Duration, Track Count, Creation Date). |
| `.playlist delete <name>`      | Permanently deletes a playlist.                                           |

<Note>
  When typing a playlist name, ZEON will provide Discord Auto-Complete suggestions based on your saved playlists to make selection faster.
</Note>

***

## Managing Tracks

You can easily add the song you are currently listening to, or search for a specific song to add.

| Command                                | Description                                                                                                                    |
| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- |
| `.playlist add <playlist>`             | Adds the **currently playing track** to the specified playlist.                                                                |
| `.playlist add <playlist> <query>`     | Searches for the query (using your default `.source`) and adds the first result to the playlist without interrupting playback. |
| `.playlist remove <playlist> <number>` | Removes a specific track number from the playlist.                                                                             |

***

## Loading Playlists

When you're ready to listen, you can load your entire playlist into the queue at once.

| Command                     | Description                                                      |
| :-------------------------- | :--------------------------------------------------------------- |
| `.playlist play <playlist>` | Loads all tracks from the playlist into the active server queue. |

*(If you want to shuffle the tracks while loading them, use `.playlist play <playlist> True`)*

***

## The Liked Playlist

When you click the green **Like (❤️)** button on the interactive `.nowplaying` control panel, ZEON automatically saves that song to a special, auto-generated playlist called your **Liked Playlist**.

You cannot delete or rename the Liked Playlist, but you can view, edit, and play it just like any other custom playlist!