Notifications Widget

The Notifications widget shows the app's notifications for the signed-in user. Use it to give users a place to see alerts, messages, and updates directly on a page.

When to use this

• You want to give the user a single view of their notifications
• You need to show the number of unread notifications in a heading
• You want a notification icon in the app's layout that expands into a list

How it works

The widget fetches the signed-in user's notifications and shows them as a list. You set a title that can include variables for the notification count, and a fallback text shown when the user has no notifications. You can also choose to only show unread ones.

Add a notifications widget

1. Open the Design editor for your applet.
2. Add the Notifications widget to the page.
3. Open the widget settings.
4. Enter a Title and a fallback text for the empty state.
5. Turn on Only unread if you want to limit the list.

Widget settings

Setting	Description
Title	The text shown above the notifications list. Supports the variables $messageCount (total number of notifications) and $unreadMessageCount (number of unread).
Text when no notifications	The text shown when the user has no notifications. Default is "No notifications".
Only unread	Limits the list to unread notifications. Read notifications are hidden.

Example

Scenario: You want a notifications panel on the home page with the unread count right in the heading.

1. Add a Notifications widget to the home page.
2. Set Title to You have $unreadMessageCount unread notifications.
3. Set Text when no notifications to You're all caught up — no new notifications.
4. Turn on Only unread.

The page now shows the unread count directly in the title and lists only the unread notifications.

Tips

TIP

Use $unreadMessageCount in the title for a strong visual signal about unread notifications — for example Notifications ($unreadMessageCount). The variable is replaced with the number in real time.

TIP

For a notification icon in the header (a bell with a number) — place the widget in the shared layout and style it with the style editor so it becomes compact.

Common mistakes

WARNING

Variables like $messageCount only work in the Title field. They are not expanded in the empty-state text.

WARNING

Only unread affects display only — old unread notifications are not marked as read automatically. The user has to mark them themselves.