Spotify: Add to Queue

Search for a song by name (or a Spotify link) and add it to your Spotify playback queue. This is the main action for song request systems - connect it to a Twitch chat command, a Channel Point redeem, or any other event.

When a song is queued, TipLink can automatically post a confirmation to chat. When the requested track actually starts playing, you can fire a separate alert to show it on screen - great for a live "Now Playing" notification.

What You Need

A Spotify account connected in TipLink's Platforms page (see Spotify setup →)
Spotify Premium - the queue API is not available on free accounts
Spotify open and actively playing on at least one device (see No Active Device for options)

Quick Start

Create or edit an alert.
Click Add Action and select Spotify: Add to Queue.
Select your Spotify Account from the dropdown.
Set the Song Query to {{message}} (for a chat command like !sr) or {{user_input}} (for a Channel Point redeem).
Enable Strip Command Prefix if your viewers type a command like !sr Never Gonna Give You Up so TipLink strips the !sr automatically.
Save and test using the Test Event Tool.

Configuration Options

Setting	Description	Default
Spotify Account	The connected Spotify account to add songs to the queue on.	-
Song Query	The song to search for. Supports placeholders. Can be a song title, an artist and title, a Spotify track URL (`https://open.spotify.com/track/…`), or a Spotify URI (`spotify:track:…`).	-
Strip Command Prefix	When enabled, any leading chat command (e.g. `!sr`) is automatically removed from the resolved query before searching. Enable this when the Song Query is `{{message}}` and viewers use a `!command song name` format.	On
No Result Behavior	What to do when no matching track is found on Spotify. `Log Error` records a failure in the Activity page. `Silent` skips the action without logging an error - useful when you have a follow-up action that should still run.	Log Error
No Active Device Behavior	What to do when Spotify is not playing on any device. `Log Error` records a failure. `Silent` skips quietly. `Play Now` finds any available Spotify device and starts playing the requested track directly - useful for bot-driven sessions.	Log Error

Song Query Tips

The Song Query field accepts:

Search text - e.g. Never Gonna Give You Up or Rick Astley Never Gonna Give You Up. TipLink searches Spotify and picks the closest match.
Spotify track link - paste a link from Spotify (e.g. https://open.spotify.com/track/…). TipLink fetches that exact track.
Placeholders - e.g. {{message}} or {{user_input}} to use whatever the viewer typed.

No Active Device Behavior

Option	Behaviour
Log Error	Records a failure in the Activity page. The request is lost.
Silent	Skips the action without any log entry. Use when a fallback is handled elsewhere.
Play Now	Finds any available Spotify device (preferring active → computer → other) and starts playing the requested track immediately, bypassing the queue. A log entry is still written confirming the direct play.

Play Now

If Spotify is often closed or idle when requests come in, use Play Now so songs always start playing rather than failing silently.

Output Placeholders

After this action runs, the following values can be used in later actions on the same alert - for example, to include the song name in a chat message.

Placeholder	Description
`track_name`	Name of the track that was queued
`artist_name`	Artist(s) of the queued track
`album_name`	Album of the queued track
`track_url`	Spotify link to the queued track
`track_uri`	Spotify URI of the queued track
`resolved_query`	The final search term used (after removing the command prefix)

Example: Chat confirmation message

Add a Twitch: Send Chat Message action after this one and set the message to:

@{{username}} - Added "{{ spotify_add_to_queue.track_name }}" by {{ spotify_add_to_queue.artist_name }} to the queue! 🎵

Common Setups

Chat Command (`!sr`)

Trigger: Twitch Chat Message containing !sr

Setting	Value
Song Query	`{{message}}`
Strip Command Prefix	✅ Enabled
No Result Behavior	Log Error
No Active Device Behavior	Log Error

When a viewer types !sr Never Gonna Give You Up, TipLink strips the !sr prefix and searches for Never Gonna Give You Up.

Channel Point Redeem

Trigger: Twitch Channel Points Reward (with viewer text input enabled on the reward)

Setting	Value
Song Query	`{{user_input}}`
Strip Command Prefix	❌ Disabled
No Result Behavior	Log Error
No Active Device Behavior	Log Error

The viewer's text input is used directly as the search query - no command prefix to strip.

Direct Spotify Link

Set the Song Query to a {{message}} placeholder and instruct viewers to paste a Spotify track URL directly. TipLink detects the URL and fetches the exact track without any fuzzy matching, so viewers always get the exact song they linked.

Tips

Combine this action with Spotify: Add to Playlist on the same alert to queue the song and save it to a permanent playlist at the same time.
Use the Song Added to Queue event (under Spotify triggers) to fire a chat confirmation the moment a song is queued, before it starts playing.
Use the Song Request Started Playing event to show an on-screen overlay when the requested song actually begins.
To restrict song requests to subscribers only, add a condition to your alert trigger.

What You Need​

Quick Start​

Configuration Options​

Song Query Tips​

No Active Device Behavior​

Output Placeholders​

Example: Chat confirmation message​

Common Setups​

Chat Command (!sr)​

Channel Point Redeem​

Direct Spotify Link​

Tips​