Alert Group
The Alert Group primitive does the same job as the Alert widget — it animates in when a follow, sub, cheer, gift or raid happens — but instead of a pre-built text-and-image layout, you compose the children yourself. Add it from Add Widget → Primitives → Alert Group, then nest your own widgets inside it.
Use it when you want an alert that's more than a line of text and a picture: a custom card with multiple images, decorative shapes, your own text styling, or extra elements that all animate together.
How it works
- Add an Alert Group to your overlay.
- Nest your own widgets inside it — Text, Image, Colour, and so on.
- When an alert fires, the whole group animates in together using the group's animation settings, holds, then animates out.
The animation settings are the same as the Alert widget — Animation, Easing, In/Out duration, Hold and Backdrop.
Showing the alert's details
The children you nest can display the live alert's details through the variable picker — the alert's message, the contributor's name, the amount, and so on. Add a Text widget inside the Alert Group and bind its content to an alert value to show, for example, "NewViewer just subscribed!".
Alert Group vs Alert
| Alert | Alert Group | |
|---|---|---|
| Layout | Pre-built (text + image), locked | You build it |
| Best for | A quick, clean alert | A bespoke alert design |
| Children | Managed for you | Yours to compose |
As with the basic Alert, what each alert says and which sound it plays comes from your Alerts settings — the widget is the on-screen presentation.