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

# Personal Music Playlists

> Create, fill, edit, reorder, share, and delete personal Scrump music playlists in Discord.

Scrump playlists belong to your Discord account, so you can reuse them across servers where Scrump Music is available. They are separate from the temporary queue playing in one server.

## Create a playlist

Create an empty playlist:

```text theme={null}
/playlist create new name:Road trip description:Songs for the drive
```

Or copy the server's current queue into a new playlist:

```text theme={null}
/playlist create from-queue name:Friday night
```

Creating from the queue requires an active queue and copies songs in their current order, up to your playlist limit.

## Add a song by search or Spotify link

Run `/playlist songs add`, choose one of your playlists, and enter either a song name or a supported Spotify URL.

```text theme={null}
/playlist songs add playlist:Road trip search:Dreams Fleetwood Mac
/playlist songs add playlist:Road trip search:https://open.spotify.com/track/0ofHAoxe9vBkTCp2UQIavz
```

The `search` field accepts the same autocomplete results, raw song names, and full Spotify track, album, artist, or playlist URLs as `/play`.

<Warning>`/playlist songs add` always adds one song. A Spotify album, artist, or playlist URL saves only the first song Scrump resolves. Use `/play` when you want to expand a collection into the server queue, then use `/playlist create from-queue` if you want to save that queue as a playlist.</Warning>

See [Playing songs and Spotify links](/features/music/playing-songs) for supported URL formats and common link fixes.

## Save the song playing now

Run:

```text theme={null}
/playlist songs add-now-playing playlist:Road trip
```

This saves the current song without making you search for it again. If there is no active queue or no song is playing, start a song with `/play` and retry the command.

<Note>The former `/playlist add-current` command is now `/playlist songs add-now-playing`.</Note>

## View your playlists and songs

* `/playlist my-playlists` lists your playlists and their song counts.
* `/playlist view playlist:` shows one playlist and its contents.
* `/playlist songs list playlist:` also shows the songs in one playlist.

Playlist choices use Discord autocomplete, so start typing the playlist name and select the intended result.

## Edit and arrange a playlist

| Command                            | Result                                                         |
| ---------------------------------- | -------------------------------------------------------------- |
| `/playlist edit name`              | Renames a playlist                                             |
| `/playlist edit description`       | Changes its description                                        |
| `/playlist reorder-songs`          | Moves a song from one numbered position to another             |
| `/playlist songs remove`           | Removes one song selected from autocomplete                    |
| `/playlist songs remove-all-after` | Keeps songs through a position and removes everything after it |
| `/playlist delete`                 | Permanently deletes the playlist                               |

Review `/playlist view` before bulk removal or deletion so you have the correct playlist and position.

## Share a playlist

Run `/playlist share` to create a private response containing an import link. Anyone who has that link can import a copy of the playlist into their own Scrump music library.

Run `/playlist unshare` to disable the current share link. Imported copies already created by other users are not removed.

<Tip>Treat a playlist share link like any other unlisted link: send it only to people you want to have access to the playlist contents.</Tip>

## Playlist limits

| Account access     | Personal playlists | Songs per playlist |
| ------------------ | -----------------: | -----------------: |
| Free, Plus, or Pro |                  3 |                 30 |
| Scrump Blue        |                500 |             10,000 |

Plus and Pro are server plans and do not increase a member's personal playlist storage. Scrump Blue is the user subscription that expands personal playlist limits.

## Related guides

* [Play songs and supported Spotify links](/features/music/playing-songs)
* [Manage the current queue](/features/music/queue-and-controls)
* [Troubleshoot playlist errors](/features/music/troubleshooting)
