> ## 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.

# Playing Songs and Spotify Links

> Play music by song name or supported Spotify link, then view the current song, lyrics, and playback status.

Use `/play` to add music to the server's shared queue. The `search` field accepts a song name, a result from Discord autocomplete, or a supported Spotify URL.

## Play a song by name

Start typing a title, artist, album, or a combination of them. Choose an autocomplete result when you see the correct song, or submit the text and Scrump will use the best Spotify search match.

```text theme={null}
/play search:Blinding Lights The Weeknd
```

Adding the artist is the easiest way to avoid a cover, remix, or another song with the same title.

## Play a Spotify link

Paste a full HTTPS link from `open.spotify.com` into `/play`.

| Spotify link | What `/play` adds                                |
| ------------ | ------------------------------------------------ |
| Track        | The linked song                                  |
| Album        | Songs from the album, up to the active limits    |
| Artist       | The artist's top tracks, up to the active limits |
| Playlist     | Songs from the playlist, up to the active limits |

```text theme={null}
/play search:https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT
/play search:https://open.spotify.com/album/4aawyAB9vmqN3uQ7FjRGTy
/play search:https://open.spotify.com/artist/1vCWHaC5f2uS3yhpwWbIA6
/play search:https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M
```

Normal Spotify sharing parameters such as `?si=...`, `www.open.spotify.com` links, and links containing a Spotify locale in the path are accepted.

<Note>Scrump uses Spotify to identify the music and collect its title, artist, album, and artwork. It then matches that song through its normal playable music catalog; it does not stream audio directly from Spotify. A Spotify item can therefore be valid but unavailable to play.</Note>

## Supported and unsupported Spotify formats

Use one of these full URL forms:

```text theme={null}
https://open.spotify.com/track/...
https://open.spotify.com/album/...
https://open.spotify.com/artist/...
https://open.spotify.com/playlist/...
```

Scrump does not accept:

* Shortened `spotify.link` URLs
* `spotify:track:...` and other Spotify app URIs
* Links beginning with `http://`
* Episode, show, or other non-music Spotify resource links
* Links from domains other than `open.spotify.com`

If the Spotify app gives you a shortened link, open it in a browser and copy the resulting `https://open.spotify.com/...` address. You can also search for the song by name instead.

## Queue limits for albums, artists, and playlists

Collection links can add multiple songs, but Scrump stops at the first applicable limit. This can include:

* A maximum of 500 resolved songs from one Spotify link
* The remaining queue capacity
* The server's maximum imported playlist size
* The maximum number of tracks one member may queue
* The server's minimum or maximum allowed track duration
* A blocked song

If only part of a Spotify collection is added, check the queue and ask a DJ or member with **Move Members** to review the server's music settings.

## View the current song

Run `/now-playing` for the current title, artist, progress, requester, and playback state. Its compact controls let listeners refresh the status, pause or resume playback, and open lyrics or the audio filters panel as a new message without replacing the shared now-playing panel.

Run `/queue view` when you also want to see upcoming songs. Its controls include the same public **Lyrics** and **Filters** buttons.

## Show lyrics

Use the **Lyrics** button on `/now-playing` or `/queue view`, or run `/lyrics` while a song is playing. Lyrics require server Plus or Pro, which unlocks them for everyone in the server, or your own Scrump Blue subscription. [Scrump Blue is a personal subscription](/help-center/buying-scrump-blue) whose music benefits follow you into any active Scrump voice channel you join.

Lyrics depend on a matching result being available. If Scrump cannot find lyrics for that exact recording, try another version of the song.

## Join or leave voice

* `/join` makes Scrump join your current voice channel without adding a song.
* `/leave` makes Scrump leave voice and clears the active queue.

For playback changes after Scrump has joined, move into the same voice channel as Scrump first.

## Next steps

* [Manage the queue and playback controls](/features/music/queue-and-controls)
* [Save music in a personal playlist](/features/music/playlists)
* [Fix Spotify and playback problems](/features/music/troubleshooting)
