Counters

A counter is a chat command that goes up by one each time someone uses it. Counters are useful for tracking running totals on stream, such as deaths per session, retries, donation milestones, or any other recurring tally.

Counters are managed on the Counters page (/counters), separate from regular commands. In chat they behave like a normal command: a viewer types the trigger, the bot responds with the message you configured, and the stored count goes up by one.

How it differs from a regular command

	Custom command	Counter
Response	Fixed template with the placeholders `{user}`, `{displayname}`, `{channel}`.	Same, plus the additional `{count}` placeholder.
State	None — the command forgets every use.	Stores a count value that goes up by one for each use and persists across sessions.
Reset	Not applicable.	Team members with the right permission can override or reset the count from the dashboard.

In all other respects a counter is configured like a custom command: trigger, aliases, cooldowns, permission, and an 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 channel.
Message	Up to 400 characters. Placeholders you can drop in: `{count}`, `{user}`, `{displayname}`, `{channel}` — the Insert variable chips in the editor add them with one click.
Counter value	The starting number when creating; the current number when editing. Type a new number to override; click the reset icon next to it to set it back to 0.
Global cooldown (s)	Time the bot must wait between any two uses of this counter, no matter who triggered it. `0` = no limit. Maximum 86 400 (24 h).
Per-user cooldown (s)	0 = no limit. Same maximum.
Minimum role	Same six-tier scale as commands (Everyone / Follower / Subscriber / VIP / Moderator / Broadcaster).
Enabled	If off, the trigger is reserved but the bot stays silent.

Example

Trigger: !deaths
Aliases: !died, !rip
Message: Death count for this stream: {count}.
Cooldowns: 5 s global, 0 per-user

After seven invocations, chat displays: "Death count for this stream: 7."

Editing a counter

Click the edit icon on the row. The dialog shows the current count. If a chat use increases the counter while the dialog is open, your save will not undo that increase — streamion.bot only writes a new count value when the field is different from what it was when you opened the dialog. So you can safely edit the message text mid-stream without losing recent counts.

Who can trigger a counter?