Discord

Discord Integration

The Discord destination sends a message to a Discord channel every time your track changes. It works through Discord’s built-in webhook system. No bots, no OAuth flows, no extra permissions required. Once the webhook URL is configured in Now Playing, messages are posted automatically with no further interaction needed.

This is popular for DJ streams and music communities where listeners want to follow along with the set, request tracks, or log what was played.

What You’ll Need

• A Discord server where you have Manage Webhooks permission (or are the server owner).
• A channel designated for track updates. This can be a dedicated #now-playing channel or an existing channel where you want track posts to appear.

Step 1: Create a Webhook in Discord

1. Open Discord and navigate to the server and channel where you want track updates to appear.
2. Right-click the channel name in the sidebar and select Edit Channel, or click the gear icon that appears when you hover over the channel.
3. In the channel settings, go to Integrations in the left menu.
4. Click Webhooks, then click New Webhook.
5. Give the webhook a recognizable name such as “Now Playing”. You can optionally upload a custom avatar. Your logo or a turntable icon works well.
6. Confirm the webhook is pointed at the correct channel. You can change the channel using the Channel dropdown if needed.
7. Click Copy Webhook URL. Keep this URL safe. Anyone with it can post to your channel.
8. Click Save.

Note

Webhook URLs look like https://discord.com/api/webhooks/1234567890/abcdef.... Do not share this URL publicly, as anyone who has it can post messages to your channel.

Step 2: Configure in the Now Playing Dashboard

1. Open the Now Playing dashboard and go to Settings in the left sidebar.
2. Under Destinations, click Discord.
3. Paste the webhook URL you copied from Discord into the Webhook URL field.
4. Choose a Message Format: Rich Embed (default) or Simple Text.
5. If using Simple Text, customize the Message Template using template variables (see below).
6. Toggle the Discord destination on.

Now Playing will post a message to your Discord channel the next time your track changes.

Message Format

Rich Embed (Default)

By default, Now Playing posts messages as Discord rich embeds. These are formatted cards that include the track title, artist, album, and optionally the album artwork. You can toggle artwork on or off using the Show Album Art option.

Simple Text

If you prefer plain text messages, switch the Message Format to Simple Text and enter a Message Template using the variables below.

Template Variables

When using Simple Text format, you control exactly what appears in each Discord message using a template string with double-brace variables. The following variables are available:

Variable	Description
{{artist}}	Artist or performer name
{{title}}	Track title
{{album}}	Album or release name
{{bpm}}	Track BPM
{{key}}	Musical key (e.g., Am, F# maj)
{{label}}	Record label
{{genre}}	Genre
{{remixer}}	Remixer name
{{releaseDate}}	Release date
{{isrc}}	ISRC code
{{link}}	First available streaming link
{{beatportUrl}}	Beatport link
{{spotifyUrl}}	Spotify link
{{appleMusicUrl}}	Apple Music link

A simple format like Now playing: **{{artist}}** - {{title}} produces clean, readable messages. You can also include emoji directly in the format string, for example: 🎵 **{{artist}}** - {{title}} [{{bpm}} BPM].

Discord messages support standard Markdown formatting:

• **bold** for bold text
• *italics* or _italics_ for italic text
• __underline__ for underlined text
• > quote for block quote style
• `inline code` for monospace text

Note

If a track is missing a field (for example, no album name), the corresponding variable is replaced with an empty string. Design your format string to read naturally even when some fields are absent.

Cooldown

The Cooldown setting controls the minimum time between Discord posts (5 to 300 seconds). This prevents spam during rapid track changes or transitions. The default is 30 seconds.

Testing Your Configuration

After entering a valid webhook URL, click the Send Test button to post a test message to your Discord channel immediately. This lets you verify the format and appearance before going live.

Posting to Multiple Channels or Servers

Discord webhooks are channel-specific. Each webhook URL corresponds to exactly one channel in one server. To post track updates to multiple channels or servers, create a separate webhook in each target channel and configure a separate Discord destination for each webhook URL in Now Playing. All Discord destinations fire simultaneously on each track change.

Troubleshooting

Messages are not appearing in Discord

• Verify the webhook URL is correct and has not been deleted. You can check in Discord under Channel Settings, then Integrations, then Webhooks.
• Make sure the Discord destination is toggled on in the Now Playing dashboard.
• Confirm the Now Playing desktop app is running and connected to your DJ software. Track changes only trigger when Now Playing detects a new track.

“Invalid Webhook Token” or similar error

The webhook URL may have been regenerated or deleted. Go back to Discord, create a new webhook, and update the URL in the Now Playing dashboard.

Messages appear but with wrong content

Review your message template and confirm the template variables are spelled correctly with double braces: {{artist}}, {{title}}, etc. Variables are case-sensitive.

Rate limiting: messages stop appearing

Discord allows up to 30 webhook requests per minute per webhook. If you are changing tracks very rapidly (for example, during transitions), some messages may be dropped. This is a Discord platform limitation and cannot be overridden. The cooldown setting helps mitigate this under normal DJ set conditions.