What This Screen Does
This is where you see all the push notifications that have been sent (or are scheduled to be sent) to your members through the mobile app. Think of it like an outbox for app notifications. You can browse past notifications, check their delivery status, search for a specific one, and create new notifications from here.
How to Get There
Open the dashboard.
In the left-hand menu, click Notification.
You are now on the Notification List screen.
Step-by-Step Guide
1. Review the Breadcrumb Navigation
At the top of the page you will see a breadcrumb trail: Dashboard → Notification → List.
You can click Dashboard or Notification to navigate back to those screens.
2. Create a New Notification
In the top-right corner, click the + New notification button.
This takes you to the notification creation screen where you can compose and schedule a push notification.
3. Search for a Notification
Use the Search bar on the left side, below the breadcrumbs.
Start typing a keyword (such as the notification subject).
Results will appear as you type. Press Enter or click a result to navigate to it.
4. Sort Notifications
To the right of the search bar, click the Sort By button.
A dropdown menu will appear with sorting options.
Choose how you want the list ordered (for example, by sending time).
The list updates automatically when you pick a new sort option.
Control | Required | What It Does |
Search | No | Filters the list by keyword. Type and press Enter to search. |
Sort By | No | Changes the order of notifications in the list. Default is by sending time (newest first). |
5. Filter by Status
Below the search and sort controls, you will see a row of tabs — one for each status.
Each tab shows a count (badge) of how many notifications are in that status.
Tab | What It Means |
All | Shows every notification regardless of status. |
Delivered | Notifications that were successfully sent to recipients. Shown with a green badge. |
Planned | Notifications that are scheduled for a future date. Shown with a blue badge. |
Pending | Notifications that are currently being processed. Shown with a yellow badge. |
Failure | Notifications that failed to deliver. Shown with a red badge. |
Click any tab to filter the list to only that status.
The count on each tab updates based on your data.
6. Browse the Notification List
Below the tabs, notifications are displayed as horizontal cards in a two-column grid (one column on mobile).
Each card shows key details about the notification such as subject, sending time, and delivery status.
While the list is loading, you will see skeleton placeholder cards.
7. Navigate Between Pages
If there are more than 8 notifications, a pagination control appears at the bottom of the page.
Click the page numbers to move through the list.
What Happens Behind the Scenes
You open the Notification List screen
|
v
Page loads and reads the currently selected gym
|
v
API call: GET /api/push-notifications
(params: pageSize=10, pageNumber=0, sortBy=sendingTime, direction=Desc)
|
v
Server returns the list of notifications + stats in response headers (x-page-stats)
|
v
Notifications appear in the grid; tab badges update with counts
|
v
(If you click a status tab)
API call: GET /api/push-notifications (with status filter added)
|
v
List refreshes with only notifications matching that status
|
v
(If you change the sort option)
API call: GET /api/push-notifications (with new sortBy value)
|
v
List refreshes in the new order
Troubleshooting
“I do not see any notifications in the list”
Make sure you have the correct gym/location selected in the dashboard header. Notifications are scoped to the active gym.
If you just started using the platform, you may not have sent any notifications yet. Click + New notification to create your first one.
“The list is stuck loading and the cards are just grey placeholders”
This usually means the API request is still in progress or has stalled. Try refreshing the page.
Check your internet connection. If you are on a slow network, the request may take longer.
If the problem persists, contact your administrator — the push notification service may be temporarily unavailable.
“The notification counts on the tabs do not match what I expect”
The counts come from the server and reflect the totals for the currently selected gym.
If you recently sent a notification, it may still be in Pending status. Give it a few minutes and refresh the page.
Switching gyms in the dashboard header will update the counts for that gym.
“I clicked a status tab but the list did not change”
Make sure you are clicking directly on the tab text. The list should refresh automatically.
If nothing happens, try refreshing the page and clicking the tab again.
Check the browser console for errors — there may be a network issue preventing the filter request.
“Search is not returning any results”
The search feature looks through notification content. Make sure you are typing a keyword that actually appears in the notification subject or body.
Try shorter or more general search terms.
If the search is loading indefinitely, refresh the page and try again.
“I cannot find the + New notification button”
The button is in the top-right corner of the page, inside the breadcrumb area.
On smaller screens, you may need to scroll up to see it.
If the button is missing entirely, you may not have the required permissions (role) to create notifications. Ask your administrator to check your role assignments.
“Notifications show as Failure status”
A Failure status means the system could not deliver the push notification.
Common causes: your one-signal (push notification provider) keys may be misconfigured, or the recipients may not have the mobile app installed.
Check your Chain Settings to make sure the OneSignal App ID and API Key are correctly configured.
If the issue affects all notifications, contact your administrator or support.