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

# How to Play Music on Discord with a Music Bot

> Learn how to play songs and Spotify links on Discord, manage a music queue, create playlists, use audio filters, and fix common music bot problems.

The easiest way to play music on Discord is to use a music bot in a voice channel. With Scrump, members can search for songs, paste supported Spotify links, share a server queue, save personal playlists, and control playback with Discord slash commands.

This guide explains how to set up and use Scrump as a Discord music bot. For the complete command reference, open the [Scrump Music documentation](/features/music/index).

## How to add a music bot to Discord

<Steps>
  <Step title="Add Scrump to your Discord server">
    Visit [scrumpbot.com/invite](https://scrumpbot.com/invite), choose **Add to Server**, and select the server where you have permission to add apps.
  </Step>

  <Step title="Check voice permissions">
    Make sure Scrump can **View Channel**, **Connect**, and **Speak** in the voice channel. It also needs permission to send its queue and now-playing responses in the text channel where members use commands.
  </Step>

  <Step title="Join a voice channel">
    Join the voice channel where you want the music bot to play. Scrump connects to the channel occupied by the member who starts the queue.
  </Step>

  <Step title="Play your first song">
    Run `/play`, enter a song and artist in the `search` field, and select the correct autocomplete result.

    ```text theme={null}
    /play search:Blinding Lights The Weeknd
    ```
  </Step>
</Steps>

Scrump normally joins automatically when you use `/play`. Run `/join` if you want the bot to connect before choosing a song.

## How to play Spotify links on Discord

Paste a full Spotify URL into the `/play` search field. Scrump accepts HTTPS `open.spotify.com` links for tracks, albums, artists, and playlists.

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

| Spotify link | Music added to Discord                           |
| ------------ | ------------------------------------------------ |
| Track        | The linked song                                  |
| Album        | Album tracks, up to the active limits            |
| Artist       | The artist's top tracks, up to the active limits |
| Playlist     | Playlist tracks, up to the active limits         |

Scrump uses Spotify to identify the title, artist, album, artwork, and intended recording. It then matches the music through its playable catalog instead of streaming audio directly from Spotify. This means a valid Spotify item may occasionally be unavailable to play.

<Note>Use the complete `https://open.spotify.com/...` address. Shortened `spotify.link` URLs, `spotify:` app URIs, and HTTP links are not supported.</Note>

Read [Playing songs and Spotify links](/features/music/playing-songs) for every supported URL format, collection limit, and troubleshooting step.

## How to manage a Discord music queue

Every listener in Scrump's active voice channel shares the same queue. Run `/queue view` to see the current song, upcoming songs, requesters, loop mode, and navigation controls.

Common Discord music queue commands include:

* `/queue shuffle` to randomize upcoming songs
* `/queue remove song` to remove one entry
* `/queue remove my-songs` to remove songs you requested
* `/skip current-song` to skip or start a public skip vote
* `/player pause` and `/player resume` to pause or continue playback
* `/player stop` to stop playback and clear the queue
* `/now-playing` to show the current song and progress

You must join Scrump's active voice channel before changing playback. Clearing the queue with `/queue remove all` and changing server music settings require **Move Members** or a configured DJ role.

See [Queue and playback controls](/features/music/queue-and-controls) for looping, multi-song skips, cleanup commands, and Pro or Blue seeking controls.

## How to make a Discord music playlist

Scrump playlists belong to your Discord account and can be reused across servers.

Create an empty playlist:

```text theme={null}
/playlist create new name:Road trip
```

Add a song by title or Spotify link:

```text theme={null}
/playlist songs add playlist:Road trip search:Dreams Fleetwood Mac
```

Save the song currently playing:

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

You can also use `/playlist create from-queue` to save the current song and queued songs in their existing order.

<Warning>`/playlist songs add` saves one song. If you provide a Spotify album, artist, or playlist link, it saves only the first resolved track. Use `/play` to add a Spotify collection to the server queue, then `/playlist create from-queue` to save the resulting queue.</Warning>

Use `/playlist my-playlists` to find your playlists and `/playlist view` to see their contents. The [personal playlist guide](/features/music/playlists) explains editing, reordering, sharing, removal, and storage limits.

## How to use Discord music filters

Scrump supports bass boost, rotating 8D audio, reverb, nightcore, playback speed, and volume changes.

```text theme={null}
/filters toggle bass-boost
/filters toggle 8d-audio
/filters song-speed fast
/player volume volume:80
```

Filters, speed, volume, and full-queue looping require an enhanced queue. A server with Plus or Pro receives enhanced music access. A Scrump Blue member also enhances the active queue while that member is participating in its voice channel.

The [Music filters and audio guide](/features/music/filters-and-audio) explains each effect, normalizing volume and speed, and Discord voice-channel bitrate limits.

## Discord music bot permissions and DJ roles

Most members can search, queue, and control music while they are in the active voice channel. Server-wide management actions require **Move Members**, **Administrator**, or a configured DJ role.

Use these commands to manage trusted music roles:

```text theme={null}
/music-settings dj-roles add role:
/music-settings dj-roles remove role:
/music-settings dj-roles list
```

Server managers can also configure skip voting, song announcements, allowed track durations, imported playlist size, per-user queue limits, and server song blocklists. See [Music settings and permissions](/features/music/settings-and-permissions) for commands and plan requirements.

## Is the Scrump Discord music bot free?

Core playback, song searches, Spotify links, queues, current-song looping, and personal playlists are available for free. A standard queue supports up to 250 songs and targets 64 kbps audio.

Server Plus and Pro provide queues of up to 10,000 songs, target up to 256 kbps audio, and unlock filters, speed, volume, and queue looping. Scrump Blue gives similar queue benefits while the Blue member participates and expands that user's personal playlist storage, but it does not unlock server-only features such as 24/7 mode.

The actual audio quality is capped by the Discord voice channel's bitrate. Review the [Music plan comparison](/features/music/settings-and-permissions#plans-and-scrump-blue) before choosing a server plan or Scrump Blue.

## Why is the Discord music bot not playing?

If Scrump joins voice but you cannot hear music:

* Confirm you are in the same voice channel as Scrump.
* Check that Scrump is not server-muted and has **Speak** permission.
* Check your Discord user-volume setting for Scrump.
* Run `/player resume` in case playback is paused.
* Try a well-known song to determine whether one recording is unavailable.
* Use `/leave`, then start a fresh session with `/play`.

If Scrump rejects a Spotify link, use a full HTTPS `open.spotify.com` track, album, artist, or playlist URL. If a command says there is no active queue, start a song with `/play` before using now-playing, lyrics, skip, seek, or add-now-playing commands.

See [Music troubleshooting](/features/music/troubleshooting) for queue limits, playlist errors, plan requirements, missing audio, and friendly recovery steps.

## Discord music bot FAQ

### Can a Discord music bot play Spotify links?

Yes. Scrump accepts full Spotify track, album, artist, and playlist URLs in `/play`. It uses the Spotify information to identify and match playable music rather than streaming audio from Spotify itself.

### How do I play a Spotify playlist on Discord?

Paste the full `https://open.spotify.com/playlist/...` URL into `/play`. Scrump adds resolved songs until it reaches the Spotify resolution, queue, server playlist, per-user, duration, or blocklist limit.

### How do I see what song a Discord bot is playing?

Run `/now-playing` to see the current song and progress. Run `/queue view` to see the current song together with upcoming requests.

### Can everyone add songs to the Discord queue?

Members in the active voice channel can normally add songs. Server managers can limit the number of songs each member may queue and block songs that should not be played.

### Can I save a Discord music queue as a playlist?

Yes. Run `/playlist create from-queue` to copy the current song and upcoming queue into a personal playlist, up to your playlist storage limit.

### How do I keep a music bot in Discord voice 24/7?

Run `/24-7` to toggle Scrump's persistent voice mode. This feature requires a server with Plus or Pro; Scrump Blue alone does not unlock it.

## Related Discord guides

* [Scrump Music feature overview](/features/music/index)
* [Play songs and Spotify links](/features/music/playing-songs)
* [Create and manage music playlists](/features/music/playlists)
* [Fix Discord music bot problems](/features/music/troubleshooting)