Timers

Timers post a chat message on a schedule. They are typically used for recurring announcements such as Discord links, schedule reminders, or sponsor mentions. Timers are managed on the Timers page (/timers).

Creating a timer

1. Click New timer.
2. Fill in:
   • Name — internal label so you can find the timer again.
   • Message — the chat message to post.
   • Interval (minutes) — how often the message can fire (1–1440).
   • Minimum chat lines — how many chat messages must pass since the timer last fired before it fires again (default 5; set to 0 to fire on the interval alone). This stops timers from talking to an empty chat.
   • Only when live — on by default: the timer fires only while you're streaming. Turn it off to let it run even when you're offline.
   • Enabled — on by default; the timer starts running as soon as you save.
3. Save.

How timers fire

• With Only when live on (the default), a timer posts only while your channel is live on Twitch; with it off, it posts regardless.
• A timer fires when its interval has elapsed or as soon as the minimum chat lines threshold is met since its last post — whichever comes first. A busy chat can therefore see a timer slightly more often than its raw interval.
• If two timers come due at the same moment, both post — the bot does not throttle them.
• Disabling a timer stops it immediately. Enabling resumes it on its next scheduled interval.

Tips

• Stagger intervals. If you have multiple timers, give them different intervals (e.g. 12, 18, 25 minutes) to avoid bursts of bot messages.
• Keep the message short. Long timer messages every few minutes feel spammy.
• Use timers for slow info, commands for on-demand info. A !discord command and a Discord timer can coexist — the timer reminds passive viewers, the command serves active ones.