Alerts

Alerts are visual and audio notifications that display on your stream overlay when events happen — follows, subscriptions, cheers, raids, donations, and custom triggers.

Custom alerts are available on Plus plans and above.

How Alerts Work

An event occurs (follow, sub, raid, etc.)
Nexmod creates an alert entry in the queue
Your stream overlay fetches pending alerts
The alert displays with your configured template (text, image, sound, animation)
The alert is marked as played

Alert Types

Type	Trigger
Follow	A new viewer follows
Subscription	A viewer subscribes or resubscribes
Cheer	A viewer cheers with bits
Raid	Another streamer raids your channel
Donation	A donation is received from a third-party platform
Custom	Triggered manually or by an action

Alert Templates

Templates define how alerts look and sound. Each template is tied to an alert type and includes:

Property	Description	Default
Name	Template identifier	Required
Type	Which alert type this template is for	Required
Enabled	Toggle the template on or off	`true`
Duration	How long the alert displays (ms)	`5000`
Layout	JSON layout configuration	`{}`
Text Template	Dynamic text with variables	`""`
Image URL	Image to display with the alert	—
Sound URL	Sound to play when the alert fires	—
Animation In	Entry animation	`fadeIn`
Animation Out	Exit animation	`fadeOut`
Custom CSS	Override styles for this template	—

Alert Queue

Alerts are queued and played in order. The dashboard provides controls for:

Pending alerts — View alerts waiting to be played
History — See past alerts and when they played
Mark as played — Manually dismiss an alert
Clear queue — Remove all pending alerts

Dashboard Permissions

Action	Required Permission
View alerts and templates	`alerts:read` — Viewer and above
Create, edit, delete templates and manage queue	`alerts:manage` — Moderator and above