Skip to content
Docs

Alertbox

Pop up an animated alert with sound and voice for every follow, sub, Bits, Kicks, raid and Ko-fi tip.

View as Markdown
On this page

The Alertbox pops up whenever something happens on your channel. One Alertbox covers every event type, so most overlays need just one. You decide which events it shows, what it says, which sound plays and whether a voice reads it out.

It works with Twitch and Kick. Ko-fi donations, memberships, commissions and shop orders arrive through your Ko-fi connection.

Add it

  1. Connect your channel under Settings → Connections.

  2. Click Add in the toolbar (or press W) and pick Alertbox under Alerts & Goals. Place it where alerts should appear.

  3. In the settings card, pick an Event type to edit it. Each type has its own switch, such as Show follows or Show raids.

  4. Send a test alert and check it on the canvas and in OBS.

Write your alerts

Every event type has its own Message / TTS line. Placeholders fill in the details:

PlaceholderBecomes
{name}The viewer's name
{amount}Bits, months, gifted subs or the tip amount
{tier}The sub tier
{message}The viewer's message
{viewers}Raid size

Next to the text, each type can have its own Media (optional) and Sound (optional). Without one, the Default alert sound plays. Bundle rapid gifts groups a gift bomb into one alert instead of many. For Bits, Kicks and Ko-fi donations you can set a minimum amount.

Sound and voice

Turn on Read alerts out loud and pick a Voice. What gets read chooses between the whole alert line and only the viewer's message. Voice for this type overrides that per event, so you can, for example, read out subs but never follows.

During the stream

Select the Alertbox and quick actions show up above it: Skip alert and Pause, with options to pause for 5 minutes or until you resume. The same actions are in the Deck and on a Stream Deck.

Your mods can do it from chat:

  • !alerts skip skips the alert on screen
  • !alerts mute 5 pauses alerts for 5 minutes, !alerts mute until pauses until you resume
  • !alerts unmute resumes right away

Tips

  • How long it stays (seconds) and Card width (px) are the first things to tune for your layout.
  • Memberships, commissions and shop orders from Ko-fi are off by default. Turn them on per event type if you use them.
  • More on events, testing and fixing silent alerts: Alerts and Troubleshooting.

Looks

Pick a look under Look in the settings card. Every look is a complete style; colors and fonts you set yourself stay on top. 16 looks are available:

  • Standard
  • Miami
  • Loot Drop
  • Comic Pop
  • Cinematic
  • Esports
  • Terminal
  • Blocky
  • Lofi
  • Neon Pulse
  • Midnight
  • Pastel Pop
  • Retro Arcade (Video)
  • Gilded
  • Gold Neon
  • Minimalism Dark

Command reference

Every chat command this widget understands, with the default command names. Values in angle brackets are placeholders, for example a number.

CommandWhat it does
!alerts skipSkip the alert currently on screen
!alerts mute <5>Pause alerts for N minutes (default 5). Use "!alerts mute until" to pause until resume
!alerts unmuteResume alerts immediately

Settings

All settings live in the floating settings card on the right of the editor. Defaults are what a new widget starts with.

Appearance

SettingDefaultValuesNotes
Accent colorLook defaultAny colorBeam, stripe and amount. Leave empty for the look's red.
MotionFullFull, Calm (slower beam), Static (no beam)
Standard animationFadeFade, Slide Up, Type-On, Blur Reveal, Gold Bloom, Stagger Rise, Flip, Scramble and 8 more
Name fontLook defaultLook default, Anton, Archivo Black, Unbounded, Bangers, Titan One
How long it stays (seconds)63 to 15
Scale (%)3216 to 6432 = native size
Max card width (px)900420 to 1200The card hugs the alert; long names and messages wrap at this width

Content

SettingDefaultValuesNotes
Event typeFollowFollow, New Sub, Gift Sub, Resub, Bits / Kicks, Raid, Ko-fi Donation, Ko-fi Membership and 2 more
Show followsOnOn or off
Message / TTS line{name} just followed!Text
Media (optional)EmptyText, e.g. Paste a URL, upload a file or choose from Library
Sound (optional)EmptyText
Voice for this typeUse the global TTS settingUse the global TTS setting, Always read out loud, Never read out loud
Show new subsOnOn or off
Message / TTS line{name} just subscribed! ({tier})Text
Show gift subsOnOn or off
Message / TTS line{name} gifted {amount} subs!Text
Bundle rapid giftsOnOn or off
Show resubsOnOn or off
Message / TTS line{name} {amount} months! {message}Text
Show Bits and KicksOnOn or off
Message / TTS line{name} cheered {amount}! {message}Text
Min amount (0 = no minimum)00 to 1000
Show raidsOnOn or off
Message / TTS line{name} is raiding with {viewers} viewers!Text
Show Ko-fi donationsOnOn or off
Message / TTS line{name} donated {amount}! {message}Text
Min donation (0 = no minimum)00 to 100
Show Ko-fi membershipsOffOn or off
Message / TTS line{name} joined the membership{tier}!Text
Show Ko-fi commissionsOffOn or off
Message / TTS line{name} ordered a commission for {amount} {currency}!Text
Show Ko-fi shop ordersOffOn or off
Message / TTS line{name} bought merch for {amount} {currency}!Text

Sound

SettingDefaultValuesNotes
Default alert soundBuilt-in soundText
Volume800 to 100
Read alerts out loudOffOn or off
VoiceHarper (English US, female)Harper (English US, female), Amy (English US, female), Ryan (English US, male), Mason (English US, male), Alba (English UK, female), Callum (English UK, male), Thorsten (German, male), Kerstin (German, female) and 13 more
Voice volume700 to 100
What gets readEvery alert (the whole alert line)Every alert (the whole alert line), Only the viewer's message
Gold Neon audioVideo soundVideo sound, Configured alert sound, Muted
Retro Arcade audioVideo soundVideo sound, Configured alert sound, Muted

Advanced

SettingDefaultValuesNotes
Terminal channel nameEmptyText

Was this page helpful?