Counters
A counter is a chat command that increments every time it fires. Use them for the running tally jokes streamers love: deaths per stream, "lost the bit" counter, hydration reminders, on-stream coffee count, …
Counters live on the Counters page (/counters) and are managed separately from regular commands, but they show up in chat the same way: someone types the trigger, the bot replies.
How it differs from a command
| Custom command | Counter | |
|---|---|---|
| Response | Static template, expanded with {user}, {displayname}, {channel}. | Same, plus {count}. |
| State | Stateless. | Persists a count value, atomically incremented per invocation. |
| Reset | n/a | Owner/Admin/Mod can override or reset to zero from the UI. |
A counter is otherwise the same shape as a custom command: trigger, aliases, cooldowns, permission, enabled toggle.
Creating a counter
Click New counter on /counters and fill in:
| Field | Notes |
|---|---|
| Trigger | Starts with !, lowercase, letters/digits/underscore/hyphen, max 32 chars. Example: !lost. |
| Aliases | Comma-separated. Up to 10. Each alias must be unique within your workspace. |
| Message | Up to 400 characters. Template variables: {count}, {user}, {displayname}, {channel}. |
| Counter value | Initial value when creating; current value when editing. Edit it to override; click the reset icon to set it back to 0. |
| Global cooldown (s) | 0 = no limit. Maximum 86 400 (24 h). |
| Per-user cooldown (s) | 0 = no limit. Same maximum. |
| Minimum role | Same five-tier scale as commands (Everyone / Subscriber / VIP / Moderator / Broadcaster). |
| Enabled | If off, the trigger is reserved but the bot stays silent. |
Example
- Trigger:
!lost - Aliases:
!died, !rip - Message:
Streamer was lost for the {count}. time today. - Cooldowns: 5s global, 0 per-user
After 7 invocations, chat sees: "Streamer was lost for the 7. time today."
Editing a counter
Open the row's edit dialog. The dialog shows the current count. If a chat message increments the counter while the dialog is open, your save won't overwrite that increment unless you actually change the count value yourself — the count override is only sent when the field differs from what it was when the dialog opened.
Permissions to use the page
The Counters page is only visible to workspace members who have the counters.manage permission. By default that includes the Owner, all Admins, and all Moderators — see Team & permissions if you want to revoke it for a role.
The minimum role field on the counter itself is independent of counters.manage: it controls which Twitch chatters in your channel can trigger the counter, not who can edit it on the dashboard.