Purpose:
StreamElements offers a powerful and versatile chatbot designed to enhance engagement and interaction during your streams. This guide gives a short overview of everything the chatbot can do — commands, user management, modules, timers, counters, spam filters, variables, and the Viewer Queue — with links to our official documentation for the full reference on each, plus every other chatbot resource you might need in one place.
Prerequisites:
- If you're setting up the chatbot for the first time, follow the guide for your platform:
Table of Contents
- What the Chatbot Does
- Commands
- User Management
- Modules
- Timers
- Counters
- Spam Filters & Banned Words
- Variables
- Viewer Queue
- Chatbot on Kick
- Settings
- Troubleshooting
- Additional Resources
What the Chatbot Does
The main use of the chatbot is to let your viewers use commands to get more information or trigger specific actions. Commands are grouped based on the required user level to run them — by default, "Everyone", "Moderators", and "Super Moderators".
Commands
Commands are split into two types:
- Default commands — a wide range of ready-to-use commands. You can't customize their responses, but you can change settings like user level, availability, cost, cooldowns, and aliases.
-
Custom commands — commands you create yourself, manageable either from the Creator Dashboard or directly in chat with the
!commandcommand (e.g.!command add test This is a test command).
📖 Commands — Full Docs →
📖 Getting Started: Creating Your First Command →
User Management
User Management lets you give users special permissions by grouping them into user levels. All commands can be set to a specific user level, so you have full control over who can trigger each command. By default, viewers already have a specific user level depending on their role:
| Group | Level | Description |
|---|---|---|
| Everyone | 100 | This is the basic level of every user in chat |
| Subscriber | 250 | Your Twitch subs get this level |
| Regular | 300 | You can set this level through user management |
| VIP | 400 | Your Twitch VIPs get this level |
| Moderator | 500 | Your Twitch moderators get this level |
| Super Moderator | 1000 | You can set this level through user management |
Broadcaster (you) always sits above every level and can trigger any command.
Adding a user: click "Add new bot user", type their username, assign them to a group, and click "Add user".
Modules
Modules are features you can trigger by chat events or commands, and each can be toggled on or off with one click:
- Mini-games — Roulette, Bingo, Raffle, Duel, and Slot Machine let viewers interact with each other and/or the bot, each with its own configuration.
- Chat hype — Emote Pyramids and Emote Combos build on chat spam, and 8Ball "predicts" a chatter's future.
- Viewer Queue — lets you build a queue to play with your viewers (see its own section below).
- Live Announcements — has the bot post in chat automatically when you go live.
- Chat Alerts — the most commonly used module; lets you customize which chat events (follows, subs, cheers, etc.) get a bot response. All events are customizable except Redemptions and Merch.
Each module's settings are configured from its own tab in the Modules section of your dashboard.
Timers
Timers are automated messages that post to chat at set intervals — handy for reminding viewers to follow, sharing social links, or announcing your schedule. They can run even while you're offline, cycle through multiple messages, and require a minimum amount of chat activity to trigger. Timers are set up under Chatbot > Timers > Add New Timer in your dashboard.
Counters
Counters are an easy way to keep track of certain things in your stream — like how many times you've died in a game, or missed a cannon minion in League of Legends.
Spam Filters & Banned Words
Configure spam filters to block links, excessive caps, or repetitive messages, and maintain a list of banned words or phrases to automatically censor inappropriate language, both from the "Spam Filters" section.
Variables
Variables are placeholders (like ${1}, $(uptime), or $(leagueoflegends)) that get replaced with real values — a username, a game, a rank, a countdown — whenever a command runs. They're what make custom commands dynamic instead of static text.
Viewer Queue
Viewer Queue lets Twitch viewers join a queue to play with you — either picked at random or first-come-first-served, and you can gate entry by Followers, Subscribers, or VIPs. Make sure your chatbot is activated first (see the Prerequisites above).
You'll find it under Loyalty > Viewer Queue, or under Chat Bot > Modules > Viewer Queue > Setup Queue. Viewers join with !queue.
📖 Viewer Queue Module — Full Docs →
Chatbot on Kick
To add the bot to your Kick channel: click Join in the bot settings section of your dashboard, then give it moderator permissions by typing /mod @StreamElements in your chat.
For full setup steps and Kick-specific FAQs, see StreamElements Chatbot on Kick.
Settings
Troubleshooting
For general issues — the bot not responding, commands not working, timers not triggering:
📖 Troubleshooting — Full Docs →
For more specific issues, we also have dedicated articles:
- Moderation Guide for the StreamElements Twitch Chatbot
- Find out if a user is a known bot on Twitch
- Twitch Events Don't Appear in the Activity Feed
- Links from the bot appear as *** in Twitch chat