What This Screen Does

This is where you create a push notification to send to your members. Think of it like composing a short text message that goes out to everyone at one or more of your gym locations. You write a subject and a message, pick when it should be sent, and choose which gyms receive it.

How to Get There

Open the dashboard.
In the left-hand menu, click Notification.
Click the + New or Create button.
You are now on the Create Notification screen.

Step-by-Step Guide

1. Fill In the Details

This section is where you write the actual notification content.

Field	Required	What to Enter
Subject	Yes	A short title for the notification. Maximum 30 characters. This is what people see first, so make it clear and attention-grabbing.
Content	Yes	The body of the notification. Maximum 200 characters. Keep it short and to the point — push notifications are meant to be brief.

The Subject appears as the notification headline on the member’s device.
The Content appears below the subject as the message body.
Both fields show a validation error if you leave them empty or exceed the character limit.

2. Set the Release Time

In the Properties section, find the Release time field.
Click on it to open a date-and-time picker.
Choose the date and time you want the notification to be sent.
The time uses a 24-hour format (no AM/PM).
By default, it is set to the current date and time.
You can schedule a notification for the future — just pick a later date and time.

Field	Required	What to Enter
Release time	Yes	The date and time the notification will be sent out. Pick from the date-time picker.

3. Choose Which Gyms Receive the Notification

Open the Available in gyms dropdown.
You will see a list of all your gym locations with checkboxes.
Check one or more gyms where this notification should be sent.
By default, your currently selected gym is already checked.
At least one gym must be selected — the form will not submit without it.

Field	Required	What to Enter
Available in gyms	Yes	Select one or more gym locations that should receive this notification. At least one must be chosen.

4. Create the Notification

Click the Create button at the bottom-right of the form.
The system will:
1. Validate all your inputs (subject, content, release time, and gym selection).
2. Send the notification data to the server.
3. Redirect you back to the notification list.
You will see a green “Create success!” notification at the bottom of the screen.

What Happens Behind the Scenes

You click "Create"
        |
        v
Form validates all fields (Yup schema)
  - Subject: required, max 30 characters
  - Content: required, max 200 characters
  - Release time: required, must be a valid date
  - Available in gyms: at least one gym selected
        |
        v
API call: PushNotificationService.create({ body: formData })
        |
        v
Notification record is created on the server
        |
        v
Success notification appears ("Create success!")
        |
        v
You are redirected to /notifications (the notification list)

Troubleshooting

“I filled everything in but the Create button does not seem to work”

Double-check that all required fields are filled in.
Look for small red error messages below the fields — they tell you exactly what is wrong.
Make sure the Subject is no longer than 30 characters.
Make sure the Content is no longer than 200 characters.
Make sure you have selected at least one gym.

“I see ‘Subject must be at most 30 characters’”

Your notification subject is too long. Shorten it to 30 characters or fewer.
Count spaces and punctuation — they count toward the limit.
Try to keep it concise. For example, use “Holiday Hours Update” instead of “Important Update About Our Holiday Opening Hours”.

“I see ‘Body must be at most 200 characters’”

Your notification content exceeds the 200-character limit.
Trim the text down. Push notifications work best when they are short and direct.
If you need to share more information, consider including a brief summary and directing members to check the app for details.

“I see ‘Please select at least one gym’”

You must choose at least one gym location for the notification.
Open the Available in gyms dropdown and check at least one gym.
If you do not see any gyms in the list, make sure your system has gym locations set up. Contact your administrator if the list is empty.

The gym list is loaded from the system when the page opens.
If the dropdown is empty, try refreshing the page.
You must have at least one gym/location set up in the system before creating a notification.
If you are new to the platform, ask your administrator to set up gym locations first.

“I got an error after clicking Create”

A red error message will appear. Read it carefully — it usually tells you what went wrong.
Common causes: server timeout, network issue, or a validation problem the form did not catch.
Try again after a few moments. If the error keeps happening, contact support with the error message.

“I set a release time in the past — will it still send?”

The form does not prevent you from picking a past date and time.
However, the notification may be sent immediately or may not be sent at all, depending on how the server processes past times.
To be safe, always set the release time to the current time or a future time.

“My notification was created but members did not receive it”

Check the release time — if it is set in the future, the notification has not been sent yet. It will go out at the scheduled time.
Make sure you selected the correct gyms. Members only receive notifications for the gym they belong to.
Members must have push notifications enabled on their device. If they turned off notifications for the app, they will not see it.

“I want to edit the notification after creating it”

Go back to the notification list.
Find the notification you just created and open it.
Make your changes and click Save Changes.
Note: if the notification has already been sent (the release time has passed), editing it may not resend it to members.

Create a New Notification