> For the complete documentation index, see [llms.txt](https://docs.moodymusic.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moodymusic.xyz/features/playlists.md).

# Playlists

Moody Music supports custom playlists that persist across sessions. Save your favorite tracks and share them with others.

## Creating a Playlist

```
mplaylist create <name>
```

Creates a new empty playlist. Playlist names must be unique per user.

## Adding Songs

While a track is playing:

```
mplaylist add
```

Or add songs by name or URL:

```
mplaylist add <song-name-or-url>
```

## Viewing Your Playlists

```
mplaylist list
```

Shows all your playlists with song counts.

## Playing a Playlist

```
mplaylist play <name>
```

Queues all songs from the playlist for playback.

## Limits

| Tier    | Max Playlists | Max Songs per Playlist |
| ------- | ------------- | ---------------------- |
| Free    | 3             | 10                     |
| Premium | 10            | 100                    |

## Sharing

Playlists generate a share code that other users can use to import your playlist. Share codes are unique and can be used with:

```
mplaylist import <share-code>
```

## Persistence

Playlists are stored in PostgreSQL and survive bot restarts. All songs are referenced by their track identifier, allowing cross-session access.