Push Notifications

Push Notifications allows superuser admins to broadcast in-app notification messages to all admin users across one or more tenants. Notifications appear in the admin panel notification bell and can link to a specific page.

'alt' => 'Dashboard overview', 'caption' => 'The default Kiwire dashboard layout', 'screenshot' => true, 'class' => '', ]) Drop images into: public/assets/img/docs/{page}/{filename} --}}

Image not uploaded yet public/assets/img/docs/notifications/overview.png

What It Does

A superuser admin can compose a notification message, choose a severity type and an optional link URL, and broadcast it to admins across all tenants or a targeted subset. Admins see the notification in their header bell icon with an unread count badge. Clicking a notification navigates to the linked URL if one was set.

This is used for system-wide announcements: scheduled maintenance windows, new feature releases, license renewal reminders, or security advisories.

Superuser Only

Only superuser admins can create and broadcast notifications. Regular tenant admins can read notifications delivered to them, but the create/broadcast controls are not visible to non-superusers. The broadcast form only appears when logged in as a superuser.

Broadcast Form Fields

Field	Description
title	Short notification headline. Shown in the bell dropdown and notification list.
body	Full notification message text. Keep it concise — this is an in-app notification, not an email.
url	Optional. When set, clicking the notification navigates the admin to this URL. Use relative paths (e.g., /admin/settings) or full URLs for external links.
type	Visual style: Info (blue), Warning (yellow), Success (green), Danger (red). Controls the icon and colour in the notification dropdown.
target	Delivery scope: All Tenants (every admin on the platform) or Specific Tenants (select one or more tenant IDs from a dropdown).

Notification Inbox

Admins access received notifications via the bell icon in the top navigation bar. The icon shows an unread count badge. Clicking the bell opens a dropdown of recent notifications with their type icon, title, timestamp, and a link if provided.

• Mark as Read — click a notification to mark it as read. The unread count decreases.
• Mark All as Read — clears the unread badge in one click.

Audit Logging

Every broadcast is logged to the system-level audit trail with the following details:

• Event: notification_broadcast
• Details: title, body, url, type, target tenant IDs, broadcasting admin ID

Notification History

The history grid below the broadcast form shows all past notifications sent by any superuser. Columns include: sent at, title, type, target, sending admin, and delivery stats (how many admins received it, how many have read it).

Required Permissions

view-notifications · create-notifications (superuser only for create)