Skip to content
StreamElements Docs

!queue

Twitch
Access
Everyone
Requires
Viewer Queue module

The !queue command suite helps manage a viewer queue, often used for activities like playing games with the streamer. It allows viewers to join, check their position, and moderators to manage the queue (open, close, pick, remove).

Usage

Section titled “Usage”

The general syntax follows this pattern:

!queue <subcommand> [arguments...]

A subcommand is always required — typing !queue on its own does nothing.

Subcommands

Section titled “Subcommands”

Here’s a breakdown of the available subcommands:

join

Section titled “join”

Allows a viewer to enter the open queue.

  • Syntax: !queue join
  • Example:
    Example chat
    ViewerName:!queue join
    partner badgemoderator badgeStreamElements:@User, you have been added to the queue in position #5.

position

Section titled “position”

Checks the command user’s current position in the queue.

  • Syntax: !queue position
  • Example:
    Example chat
    ViewerName:!queue position
    partner badgemoderator badgeStreamElements:@User, you are currently position #3 in the queue.

list

Section titled “list”

Lists who is currently waiting in the queue. The bot posts up to 5 names in chat, followed by a count of how many other viewers are also waiting.

  • Syntax: !queue list
  • Example:
    Example chat
    ViewerName:!queue list
    partner badgemoderator badgeStreamElements:Currently waiting in the Viewer Games queue: UserOne, UserTwo, UserThree, UserFour, UserFive and 7 others.

open <title> (Moderator+)

Section titled “open <title> (Moderator+)”

Opens the queue, allowing viewers to join. A title for the queue is required.

  • Syntax: !queue open <title>
  • Example:
    Example chat
    moderator badgeModUser:!queue open Viewer Games
    partner badgemoderator badgeStreamElements:@Moderator, The Viewer Games queue is now open! Viewers can type !queue join to enter.

close (Moderator+)

Section titled “close (Moderator+)”

Closes the queue, preventing new viewers from joining.

  • Syntax: !queue close
  • Example:
    Example chat
    moderator badgeModUser:!queue close
    partner badgemoderator badgeStreamElements:@Moderator, The queue is now closed.

pause (Moderator+)

Section titled “pause (Moderator+)”

Temporarily stops viewers from joining the queue (similar to close, but implies temporary).

  • Syntax: !queue pause
  • Example:
    Example chat
    moderator badgeModUser:!queue pause
    partner badgemoderator badgeStreamElements:@Moderator, The queue is paused.

unpause (Moderator+)

Section titled “unpause (Moderator+)”

Resumes allowing viewers to join the paused queue.

  • Syntax: !queue unpause
  • Example:
    Example chat
    moderator badgeModUser:!queue unpause
    partner badgemoderator badgeStreamElements:@Moderator, The queue is no longer paused.

pick <random | username> (Moderator+)

Section titled “pick <random | username> (Moderator+)”

Selects a participant from the queue. You must specify either a username or the keyword random — there is no option to pick the next person in line.

  • Syntax:
    • !queue pick random (Selects randomly)
    • !queue pick <username> (Selects a specific user)
  • Example (random):
    Example chat
    moderator badgeModUser:!queue pick random
    partner badgemoderator badgeStreamElements:@LuckyViewer has been randomly selected from the queue!
  • Example (specific):
    Example chat
    moderator badgeModUser:!queue pick SpecificUser
    partner badgemoderator badgeStreamElements:@SpecificUser has been picked from the queue!

remove <username> (Moderator+)

Section titled “remove <username> (Moderator+)”

Removes a specific user from the queue.

  • Syntax: !queue remove <username>
  • Example:
    Example chat
    moderator badgeModUser:!queue remove ProblemUser
    partner badgemoderator badgeStreamElements:@Moderator, ProblemUser has been removed from the queue.

Configuration

Section titled “Configuration”
  • The Queue module must be enabled in your StreamElements Dashboard under Chatbot -> Modules.
  • Restrictions on the queue, such as the maximum queue size and which viewers are eligible to join (for example followers or subscribers only), are configured in the module settings on the Dashboard.
  • Permission levels for subcommands can be adjusted under Chatbot -> Chat Commands -> Default Commands.
Section titled “Related Commands”
  • Viewer Queue Module: Enable the queue and configure its settings (size limits, messages, and behavior) in the StreamElements Dashboard.