Notification

Notifications allow you to send push notifications directly to users' mobile devices via Firebase Cloud Messaging (FCM). You can target recipients by selecting specific roles (Student, Guardian, Teacher, etc.) or by filtering users with overdue fees. Each notification includes a title, message, and optional image attachment.

• School Admins can send notifications to any user group
• Marketing Managers can send notifications for communication campaigns and reminders
• Notifications are sent as push messages — users receive them instantly on the Stunov+ Student and Staff apps
• The user selection panel lets you hand-pick individual recipients from the filtered list
• Notifications are tracked per Session Year

Difference from Announcements

Notifications are standalone push messages sent to users — they do not require a class section or subject, and they are not displayed within the app's announcement feed. Use Announcements for class-specific academic messages, and Notifications for general school-wide broadcasts.

Notification page — create form (left), user selection (right), and notification history (bottom)

---

Create a Notification

1

Navigate to Notification

From the sidebar, click **Notification**. The Manage Notification page opens with the creation form on the left, the user selection table on the right, and the notification list at the bottom.

2

Choose the recipient type

Under **Roles**, select the filtering mode using the radio buttons: **Roles** (filter by user roles) or **Over Due Fees** (filter by students/guardians with unpaid fees). The user table on the right updates automatically based on your selection.

3

Select one or more Roles

In the **Roles** dropdown, choose one or more roles to filter the user list. Available roles include: Guardian, Student, Teacher, Driver, Helper, IT Manager, Marketing Manager, Accountant, Academic Coordinator, Transportation Manager. When "Over Due Fees" is selected, only Student and Guardian roles are available.

4

Select recipients from the user table

The right panel displays a paginated table of users matching your role/fee filter. Use the **checkboxes** to select individual users, or check the header checkbox to select all visible users. You can use the **Search** bar to find specific users by name. Navigate pages to select users across multiple pages.

5

Enter the Title

Type a clear, concise title for your notification (e.g., "Fee Payment Reminder", "School Closure Notice"). The title appears as the notification heading on users' devices.

6

Enter the Message

Write the notification body text in the **Message** field. Keep it brief and actionable — this is the main content users see in their push notification.

7

Attach an Image (optional)

Click **Upload** to attach an image to the notification. The image is displayed within the push notification on supported devices. Accepted formats: JPEG, PNG, JPG, GIF, SVG, WebP.

8

Submit

Click **Submit** to send the notification. The system sends a push notification via Firebase Cloud Messaging to all selected users who have registered device tokens. The notification immediately appears in the list below.

Create Notification — form fields (left) and user selection table with checkboxes (right)

Form Fields

Field	Type	Required	Description
Type (Radio)	Radio	Required	Choose the recipient filtering mode. **Roles**: filter users by their system role. **Over Due Fees**: filter students and guardians who have unpaid fees. Default: Roles.
Roles	Multi-select dropdown	Required	Select one or more roles to filter the user list. In "Roles" mode: all roles (Guardian, Student, Teacher, Driver, Helper, IT Manager, etc.). In "Over Due Fees" mode: only Student and Guardian.
Title	Text	Required	The notification title. Appears as the heading in the push notification on users' devices.
Message	Textarea	Required	The notification body text. This is the main content users see in the push notification.
Image	File upload	Optional	An optional image to attach to the notification. Displayed in the push notification on supported devices. Accepted formats: JPEG, PNG, JPG, GIF, SVG, WebP.
User Selection (checkboxes)	Checkbox table	Required	Select specific users from the filtered user list on the right panel. At least one user must be selected. Use the header checkbox to select/deselect all visible users.

---

Targeting by Roles vs Over Due Fees

The notification system offers two targeting modes:

Roles Mode (default)

When Roles is selected, the user table shows all users belonging to the selected role(s). This is ideal for:

• Sending general announcements to all teachers
• Notifying all parents about a school event
• Reaching staff members (drivers, helpers) about schedule changes

Roles dropdown — select one or more roles to filter the recipient list

Over Due Fees Mode

When Over Due Fees is selected, the user table shows only students and guardians who have unpaid fee balances. This is ideal for:

• Sending payment reminders to parents with outstanding fees
• Notifying students about upcoming fee deadlines

Over Due Fees mode — the user table shows only users with outstanding fee balances

User Table Pagination

The user selection table is paginated (10 users per page by default). When selecting users across multiple pages, your selections are preserved as you navigate between pages. The total user count is shown at the bottom of the table.

---

Notification History

Below the creation form, the List Notification table displays all notifications sent during the current session year.

Column	Description
No.	Row number
Image	Thumbnail of the attached image (shows "-" if no image)
Title	The notification title
Message	Notification body — long text is truncated with a clickable "Read more" link
Action	Delete button

Notification history — list of all sent notifications for the current session year

Additional Features

• Search: Use the search bar to find notifications by title or message content
• Column Visibility: Click the Columns button to show or hide specific columns (including the hidden "Type" column which shows the send_to value)
• Export: Click the Export button to download the notification list as CSV
• Refresh: Click the Refresh button to reload the table data

---

Delete a Notification

1

Click the Delete button

In the **Action** column, click the **Delete** (trash) button next to the notification you want to remove.

2

Confirm deletion

A confirmation dialog appears. Click **Confirm** to delete the notification. The notification is permanently removed from the list.

Deleting does not recall notifications

Deleting a notification removes it from the history list only. Users who already received the push notification will still see it on their devices. Push notifications cannot be recalled once sent.

---

Firebase Cloud Messaging (FCM) Setup

Notifications are delivered via Firebase Cloud Messaging (FCM). For notifications to work, your Super Admin must configure the Firebase service account:

1. Upload the Firebase Service Account JSON file in Super Admin → System Settings → Notification Settings
2. The JSON file must contain valid project_id, private_key, client_email, and client_id fields
3. Users must have the Stunov+ Student or Staff app installed with push notifications enabled — the app registers a device token (fcm_id) on login

No FCM token = no notification

Users who have never logged into the mobile app (or have disabled notifications) will not have a registered FCM token. Notifications sent to these users will silently fail. The system does not report individual delivery failures.

---

Permissions Summary

Action	Permission	Roles
View notification page	notification-list	School Admin, Marketing Manager
Send notification	notification-create	School Admin, Marketing Manager
Delete notification	notification-delete	School Admin, Marketing Manager

Feature Gate

The Notification feature is available only when the Announcement Management add-on is enabled in your school's subscription. If this feature is not visible in the sidebar, contact your Super Admin to enable it.

---

Related Pages

• Announcement — Send class-specific academic announcements with file attachments
• Dashboard — Overview of school metrics and recent activity
• Fees — Manage fee types and student payments (related to overdue fees targeting)
• Staff Management — Manage roles and staff members who receive notifications