Home / Reference / Chat commands
Chat commands
Built in commands plus notes on permissions, aliases, Match anywhere, and Advanced Settings limits. Custom commands you create live in Automations and Chat Bot.
Viewer commands
| Command | Description |
|---|---|
!join | Join the current wheel when a session is active |
!points / !points @user | Check viewer points balance (or your custom command name). Optional @username looks up that viewer when Allow checking another viewer is on (default), including a YouTube @handle. {user} is the subject; {caller} is who typed the command. Unknown login uses the not-found template; a resolved viewer with no wallet is a real 0 |
!shop / !shop 2 | Built-in command that lists Viewer Points shop buy commands and prices (or your custom command name). !shop is page 1. !shop 2 turns the page. The line does not name the currency. Twitch and YouTube pages are different lengths. Edit it from the Shop page, the same way as !addgoal. See Viewer Points. |
!givepoints @user amount | Give your own points to another viewer. Amount can be a whole number, 1k / 1m (no space), 50% of what you can spend, or all. A counter minimum stays behind. @handle resolves a YouTube chatter (recent chat, linked account, or official handle lookup) as well as a Twitch login. A recipient named all is that person, not everyone. Linked identities cannot give to themselves |
!gamble amount | Wager points on a configurable win chance roll (decimals and percents ok, e.g. 50.2 or 34.7%; 1k = 1,000 and 1m = 1,000,000 with no space; rounds to a whole stake). Optional jackpot in Advanced Settings: same roll, its own chance and payout multiple (default off, 1%, 5x). A 5x hit on 50 credits 200. {amount} stays the wager. The jackpot chat line is editable |
!giveaway | Enter an active giveaway |
!sr / !songrequest | Queue a song on the streamer's Spotify app (song name, optional artist, or a track link). Requires Spotify Connect under Integrations and Spotify Premium. Customize the reply in Chat Bot ({user}, {track}, {artist}). Set per-viewer queue caps on the Spotify Integrations card (default 5; 0 = none; leave blank for unlimited). Built in; default Everyone; does not use a Free chat command slot. |
!remove / !removesong | Remove that chatter's most recently requested song (stack: last request first). Spotify cannot delete a queued song, so ISB Suite mutes and skips it when it would play, or immediately if it is already current. Built in; default Everyone; does not use a Free chat command slot. |
!link / !linkaccept | Joins a Twitch login and a YouTube @handle into one ISB account (shared watch time, Viewer Points, walk-ons, once-per-stream limits, !contribute, Saved Lists, !sr caps, and giveaway / heist / wheel joins). Start with !link @handle (Twitch) or !link twitchlogin (YouTube). Confirm from the other chat with !linkaccept name (or !link name). Bare !link explains this and does not finish a pending. Already linked: Unlink on the Stats viewer row. Card: Chat Bot > Built-in Commands. See YouTube. |
!ISB / !software / !chatbot / !ISBSuite | Short note that this channel uses ISB Suite, plus a link to this site. Also posts that note every 30 minutes while live, in both Twitch and YouTube chats. Off until you enable it on Chat Bot > Built-in Commands. Default response: This Channel uses ISB Suite for chat bot commands, games, viewer points, and more! https://thadestroy.github.io/ISBSuiteReleases/docs/. Permission defaults to Everyone. Built in; does not use a Free chat command slot. Edit the response on the card. |
| goal contribute | On a Community Goal with Viewer Points mode, viewers type your contribute command plus a whole number (for example !goal 50) to spend 1:1. Same name as Check is ok: bare checks, amount contributes. Stop-at-limit goals reject further spend once the bar is full; a last remainder smaller than the typed amount is clamped. Optional per-stream / per-user-per-stream point caps (Advanced Settings) work the same way |
| any shop command | Spend points on shop items you configured |
Mod and broadcaster commands
| Command | Description |
|---|---|
!startwheelspin | Start a new empty wheel session; enables !join |
!endwheelspin | Stop accepting new entries |
!spinwheel | Spin the wheel |
!resetwheelspin | Clear the wheel and end the session |
!endtimer {name} | End a Live Clock or skip a delay-queue Timer countdown without running deferred actions. A custom ended look stays on screen; otherwise the clock clears. Does not fire Live Timer Ended |
!cleartimer {name} | Hide an ended Live Clock (default Mods). Does not stop a running clock, skip a delay queue, or fire Live Timer Ended |
!pausetimer {name} | Pause a Live Clock on a named Timer Widget preset |
!resumetimer {name} | Resume a paused Live Clock |
!addtime {name} {duration} | Add time to a Live Clock. One amount (5m, 30s, 1h) or pieces that add (3m 12s, 1h 3m 12s) |
!removetime {name} {duration} | Remove time from a Live Clock. Same duration as !addtime, including 3m 12s. Count up stops at 0:00 and keeps running |
!settime {name} {duration} | Set a running or paused Live Clock to a time (5m, 3m 12s, 0). Pieces add together. Does not start an idle clock. 0 ends a countdown and leaves a count-up clock at 0:00 |
!so @user / !shoutout | Shout out a channel (Nightbot style). Resolves the target, looks up their last Twitch category, and posts a templated chat line (default Mods). Customize the template in Chat Bot ({user}, {login}, {game}). Built in; does not use a Free chat command slot. For Twitch's official shoutout, use Send Message /shoutout {user} on an automation (see Send Message). |
!followage | How long a viewer has been following (optional @user). Customize the template in Chat Bot. |
!watchtime | Tracked watch time for a viewer (optional @user). Customize the template in Chat Bot; requires Stats Watch Time. |
!addcommand {name} {response} / !addcom | Create a simple Chat Bot reply command (default Mods). Example: !addcom !project Today's project is... confirms with Added !project: Today's project is.... Does not auto-add !. Fails if the name already exists. Built in; does not use a Free chat command slot. Default Response is Added {name}: {response}. Customize in Chat Bot ({command} is this built-in; {name} / {response} are the command they created). |
!editcommand {name} {response} / !editcom | Update the response text of a Chat Bot custom command (default Mods). Example: !editcom !project New text confirms with Updated !project: New text. Cannot change built-ins or Automations. Built in; does not use a Free chat command slot. Default Response is Updated {name}: {response}. |
!enablecommand {name} / !enablecom | Turn a Chat Bot custom command on (default Mods). Example: !enablecom !project confirms with Enabled !project. One name only. Does not auto-add !. Cannot change built-ins, Automations, Chat Games, Alerts, or these enable and disable commands. Built in; does not use a Free chat command slot. Default Response is Enabled {name}. |
!disablecommand {name} / !disablecom | Turn a Chat Bot custom command off (default Mods). Example: !disablecom !project confirms with Disabled !project. Same limits as !enablecommand. Default Response is Disabled {name}. |
!vpgive @user amount | Admin give points to a viewer (Twitch login or YouTube @handle) |
!vpgive all amount | Admin give the same amount to everyone currently in chat (Twitch Helix chatters plus YouTube recently-chatted; a linked account is counted once) |
!customcommand | Any custom command from Automations or Chat Bot |
!quote add … / !quoteadd | Example Saved List Add (your base command; default Mods). See Saved Lists |
Saved List Read is usually Everyone: bare base command = random entry; base + number = that entry. Configure under Chat Bot > Add Bot Message (Saved list), or open settings from Overview / Lists.
Permission levels
Custom commands and editors that expose permission use these levels:
- Everyone: any viewer
- Followers: followers, subs, VIPs, mods, broadcaster
- Subscribers: subs, VIPs, mods, broadcaster
- VIPs: VIPs, mods, broadcaster
- Moderators: mods and broadcaster only
- Broadcaster: broadcaster only
- Specific User(s): only the named viewers (no mod or broadcaster bypass)
On Chat Bot custom commands and Chat Games start commands, a role can also include named users who do not meet that role (for example Moderators plus a regular viewer). Specific User(s) stays locked to the list only. YouTube maps Subscribe to Followers, Member to Subscribers, and VIP+ to Moderators. Specific User lists accept a YouTube @handle. Full ladder: YouTube.
Aliases and Match anywhere
Command names: type the trigger the way viewers will send it in chat, including a leading ! (for example !spin). Empty command-name and alias fields show a muted !command / !alias hint. Other prefixes such as ?help still work. The app does not auto-add !.
Aliases: Automations, Chat Bot commands, Chat Games join commands, Viewer Points commands, shop items, point drop claims, Community Goal check and contribute commands, and Saved List Read/Add commands can define alternate names. The longest matching alias wins. Leftover text after a longer alias becomes {input}.
Match anywhere in message (optional): match as a whole word anywhere in chat, not only at the start. On Chat Bot custom commands this is on the Add/Edit card; on Viewer Points, Community Goals, Saved Lists, Chat Games, and Automations it is under Advanced Settings. Useful for /me !command and mid-chat triggers. Space boundary rules still apply (!spin will not match inside !spinwheel). Off by default.
Don't trigger from the broadcaster or linked bot (optional; Chat Bot, Alerts, Automations Chat Command, Chat Games start, and Saved Lists): the command will not fire from your Twitch account or a linked bot account, whether it is at the start or mid-message. Same rule either way you send chat. Off by default.
Allow checking another viewer (optional): treat the first leftover word as a viewer (@user / username). {user} becomes that person and leftover text is {input}. On by default for Viewer Points balance, Follow Age, and Watch Time. Off by default on Automations Chat Command and Chat Bot custom commands so !love pizza keeps pizza as {input}. Cooldown and permission still apply to whoever typed the command. Use {caller} for the typer when {user} is a looked-up subject.
Advanced Settings limits
Viewer Points commands (including shop redeem and point-drop claim), Chat Game join, Community Goal check and contribute commands, Saved List Read/Add, Automations, and related editors share one Advanced Settings block. Chat Bot custom commands keep aliases, Match anywhere, Don't trigger, and Allow checking another viewer on the Add/Edit card; Cooldown & Limits stay under Show Advanced.
- Permission - who may run the command
- Time cooldown - None, Global, or Per User. Optional burst: if used N times within a window you set, a longer cooldown starts. The normal per-use duration is independent and can be off.
- Per stream limits - max fires globally and/or per user (
0= unlimited); reset when a new stream session starts - Optional chat replies - separate messages for on cooldown vs hit limit (
{time}is available on cooldown replies) - Aliases and Match anywhere - as above
New limit fields default to unlimited; existing cooldowns keep working. Channel Point redemptions are different: Twitch still accepts the redeem and charges points; ISB Suite only skips running the automation when blocked (reject / refund is not supported yet).
Community Goal contribute Advanced Settings also has optional point-amount caps (max points per stream, and max per user per stream). Those are separate from max fires. 0 = unlimited. They reset on a new stream and when you Refund VP.