Alert box & designer
The Alert box widget plays a pop-up for every follow, sub, gift sub, bits, raid, channel-point redemption and donation. Select it and click Design alerts to open the Alert designer: a full-screen window with the events on the left, a live preview in the middle and every setting for that event on the right. Changes are saved immediately and the preview replays after each change.
How it works#
- Alerts are queued: if five follows arrive at once they play one after the other, with Pause between alerts in between.
- Each event has its own message, media, sound, colors, layout, duration and animation — so a raid can look completely different from a follow.
- Variants swap the GIF, sound or text from a certain amount up (e.g. 500+ bits). The highest variant reached wins.
- Text-to-speech reads donation and bits messages aloud with the browser's own voice engine in OBS.
- A minimum amount hides small bits/tips/raids — handy against spam.
Before you start#
Set it up#
On the Overlays tab, click an overlay's thumbnail or its Edit button.
Click it on the canvas (or add one: Widgets → Alert box).
Inspector → Alert designer → Design alerts.
Click Raid on the left. Tick Alert on.
E.g. {{user}} is raiding with {{viewers}} viewers! — click the token chips to insert them.
Image / GIF → pick from your library, Sound → pick a sound, Volume 70%.
Under Variants per amount click +, set From 50 and choose a different GIF and sound. Click ▶ next to it to preview.
Every setting explained#
| Design alerts | Opens the Alert designer. |
| Pause between alerts (ms) | Gap between two queued alerts, 0–10000 ms (default 500). |
| Appearance | Shared by most widgets: Background color (default rgba(0,0,0,0.55)), Text color, Corner radius (default 16), Padding (default 16), Font (Sans-serif, Serif, Monospace, Display) and an optional Background image. |
Events: Follower, Subscriber, Gift sub, Bits, Raid, Channel points, Donation. A dot shows which are on.
| Alert on | Turn this event's alert on or off. Off = nothing plays for it. |
| Message | Max 300 characters. Tokens per event — Follower: {{user}}; Subscriber: {{user}} {{months}}; Gift sub: {{user}} {{count}}; Bits: {{user}} {{bits}} {{message}}; Raid: {{user}} {{viewers}}; Channel points: {{user}} {{reward}}; Donation: {{user}} {{amount}} {{currency}} {{message}}. |
| Duration (s) | How long the alert stays, 1–30 s. |
| Animation | fade, slide-down, slide-up, zoom or bounce. fadeslide-downslide-upzoombounce |
| Minimum to show | Subscriber, Gift sub, Bits, Raid and Donation only: below this amount (months, count, bits, viewers or money) no alert plays. |
| Layout | Stacked (media above text), Side by side (media left, text right) or Text on media (text over the image/video). StackedSide by sideText on media |
| Image / GIF | Pick from your library or paste an https link. |
| Video (replaces image) | A video (e.g. a transparent WebM) instead of the image. |
| Sound / Volume | The alert sound from your library, and its volume (0–100%, default 80%). |
| Text color / Name accent | Text color, and an optional accent color for the viewer's name (Turn on / × to turn it off). |
| Font / Text size | Default or any built-in font; text scale 0.5×–3×. |
Subscriber, Gift sub, Bits, Raid and Donation. Up to 10 variants.
| + | Adds a variant 100 above the previous one. |
| From | The amount at which this variant takes over. |
| Different message | Optional; empty = the normal message. |
| Image / GIF, Sound | Optional replacements for this variant. |
| ▶ | Previews the alert at exactly this amount. |
| Bin | Removes the variant. |
Bits and Donation only.
| Text-to-speech (read the message) | Reads the viewer's message aloud after the alert text. |
| Only from amount | Minimum bits/amount before the message is read. |
| Voice | Default voice or any voice installed on this computer. Voices differ per PC — OBS uses the voices of your streaming PC, so test it there. |
| Speed | Speech rate, 0.5×–2×. |
| Play again | Replays the current event's alert with a test viewer (Kijker123). |
| Test amount | The amount used in the preview (bits, viewers, months, count, money) — use it to check variants and minimums. |
Examples#
Follower: Welcome to the crew, {{user}}! · Subscriber: {{user}} subscribed for {{months}} months 💜 · Gift sub: {{user}} gifted {{count}} subs! · Bits: {{user}} cheered {{bits}} bits — {{message}} · Raid: {{user}} raids with {{viewers}} viewers! · Donation: {{user}} tipped {{amount}} {{currency}}: {{message}}