Notifications
Tell your users something, in the panel or by email.
A notification arrives in the bell menu straight away, with nothing to refresh. With email set up, it can go out that way too.
Go to Admin > Support > Notifications.
TIP
This page is a composer, not a template editor. It has no per-event rules and no email template editor. To change the look of system emails, read Mail Settings.
The two tabs
| Tab | Purpose |
|---|---|
| Broadcast to All | Sends one notification to every user. |
| Send to Specific Users | Sends one notification to the users that you pick. |
Both tabs use the same fields.
Choosing recipients
On the Send to Specific Users tab, use the Select Users box:
- Type a name or an email address. The box shows matching users.
- Click a user to add that user. The name becomes a chip.
- Repeat for each recipient. A counter under the box shows how many users you picked.
- To remove a recipient, click the cross on the chip.
Notification fields
| Field | Description |
|---|---|
| Notification Type | The category and the colour. The options are Info, Success, Warning, Error, System, Server, Billing, Security, and Support. |
| Delivery Channel | Where the notification goes. The options are In-App Only, Email Only, and Both In-App & Email. |
| Title | The headline. The limit is 255 characters. |
| Message | The body. The limit is 2000 characters. |
| Action URL (Optional) | A link that the user can open from the notification, for example /servers. |
| Action Text (Optional) | The label on that link, for example View Details. |
| Icon (Optional) | The icon next to the notification. |
| Color (Optional) | A custom colour. Leave it empty to use the colour of the type. |
| Expires In (Hours, Optional) | The panel removes the notification after this time. Leave it empty to keep the notification. |
Click Broadcast to All Users or Send to N Users to send. Click Clear to empty the form.
Cleanup expired
Click Cleanup Expired at the top right of the page to delete every notification that passed its expiry time. The page reports how many it removed.
Automatic notifications
The panel also creates notifications by itself for these events:
- Server status changes. These changes are start, stop, crash, and installation complete.
- Billing events. These events are a processed payment, an invoice that is due, and a suspended service.
- Security events. These events are a new login, a password change, and a change to two-factor authentication.
- Support ticket replies and status changes.
- Panel updates and announcements.
The notification preferences of each user control which of these the user receives.
User notification preferences
A user opens Notification Preferences from the notification page in the client area.
| Preference | Description |
|---|---|
| Server Alerts | Server status changes. |
| Billing Alerts | Payment and invoice notifications. |
| Security Alerts | Login detections and account changes. |
| System Announcements | Panel updates and system messages. |
| Support Alerts | Ticket replies and status changes. |
| Email Notifications | Turns email delivery on or off. |
| Email Digest | None, daily, or weekly. |
The panel does not create a notification of a type that the user turned off.
Notification center
Users open their notifications from the bell icon in the header. The menu shows the most recent notifications and an unread count. Click View all notifications to open the full page. On that page a user can:
- Read every notification with its read state.
- Mark one notification, or all notifications, as read.
- Delete a notification.
- Filter by read state.
Next steps
- Mail Settings - configure SMTP for email delivery.
- Announcements - panel-wide banners and pop-ups.