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

# Music Troubleshooting

> Fix common Scrump Music errors involving voice channels, queues, Spotify links, playlists, permissions, plans, and audio.

Scrump's music errors are designed to be useful without exposing private service details. Most errors are ephemeral, which means only the person who ran the command can see them.

## Scrump says to join a voice channel

Join a Discord voice channel and retry the command. If Scrump is already active elsewhere in the server, join Scrump's current voice channel before changing that queue.

Also check that Scrump can **Connect** and **Speak** in the voice channel. A full voice channel may require Scrump to have permission to bypass its user limit.

## There is no active queue or current song

Commands such as `/now-playing`, `/lyrics`, `/playlist songs add-now-playing`, pause, skip, and seek need an active song.

Run `/play` to start the queue, wait for playback to begin, and retry the command. If you only want Scrump to connect first, use `/join`.

## A Spotify link is not recognized

Check that the link:

* Begins with `https://`
* Uses `open.spotify.com` or `www.open.spotify.com`
* Points to a track, album, artist, or playlist
* Is the full Spotify URL rather than a `spotify.link` short URL or `spotify:` app URI

If needed, open the link in a browser and copy the final `https://open.spotify.com/...` address. You can always enter the song and artist name instead.

See [supported Spotify links](/features/music/playing-songs#supported-and-unsupported-spotify-formats) for examples.

## Scrump cannot find or play a song

For a text search, add the artist and album to make the query more specific, then choose the correct autocomplete result.

A supported Spotify link identifies the intended music, but Scrump still has to match it in its playable catalog. Some regional releases, uncommon recordings, podcasts, local files, and removed music may not be available.

If a collection adds fewer songs than expected, check the queue capacity and the server's track-duration, imported-playlist, per-user, and song-blocklist rules.

## A playlist command cannot find my playlist or song

Start typing the playlist or song name and select an autocomplete choice. Do not paste a playlist's internal identifier or type a queue position from memory.

For `/playlist songs add-now-playing`, make sure a song is actively playing. For `/playlist create from-queue`, make sure the server has an active queue.

If you reached a storage limit, remove an old playlist or song. Free, Plus, and Pro users can store 3 personal playlists with 30 songs each; Scrump Blue expands this to 500 playlists with 10,000 songs each.

## A queue or Spotify collection stops early

Scrump may stop adding songs when it reaches:

* 250 queued songs on standard access or 10,000 on enhanced access
* 500 resolved songs from one Spotify link
* The server's configured maximum imported playlist size
* The server's per-user queued-song limit
* A blocked or disallowed track duration

Run `/queue view` to review what was added. A member with **Move Members** or a DJ role can review server music settings.

## A command says a plan or enhanced queue is required

Different controls have different requirements:

* Filters, playback speed, volume, and queue looping need server Plus or Pro, or a participating Scrump Blue member.
* Lyrics need Plus, Pro, or Blue.
* Seeking, rewinding, skipping forward, and restarting need Pro or Blue.
* 24/7 mode needs server Plus or Pro; Blue alone does not unlock it.

If the queue depended on a Blue member, that member must currently be participating in the active voice channel for queue-wide Blue benefits to apply.

## A command says I need Move Members or a DJ role

Ask a server administrator to grant the appropriate Discord permission or configure a DJ role with `/music-settings dj-roles add`.

DJ access is still subject to plan requirements. For example, managing a server song blocklist needs Plus or Pro in addition to music-management access.

## Scrump is connected but there is no audio

Check these Discord settings first:

* Scrump is not server-muted.
* Your Discord client has not muted Scrump or turned its user volume down.
* You are in the same channel as Scrump.
* Scrump has **Speak** permission in the channel.
* The song is not paused; try `/player resume`.

Then try another song. If several known songs fail, leave and restart the session with `/leave`, `/join`, and `/play`. If the problem continues, contact [Scrump Support](https://scrumpbot.com/support) with the server name, command used, and approximate time of the failure.

## Audio sounds distorted or too quiet

Return volume to 100% with `/player volume volume:100`, turn off active filters by running their toggle commands again, and restore normal speed with `/filters song-speed custom speed:1.0`.

Discord's voice-channel bitrate caps the effective quality. Increasing Scrump's volume or enabling bass boost does not raise that bitrate and can introduce distortion.

## Related guides

* [Play songs and Spotify links](/features/music/playing-songs)
* [Manage queues and playback](/features/music/queue-and-controls)
* [Review music settings and plan access](/features/music/settings-and-permissions)
