What This Screen Does
This is where you add a new location (sometimes called a “room” or “hall”) to one of your gyms. Think of it like labelling a specific space inside your building — for example, “Hall #1” or “Yoga Studio”. Once you save, the location becomes available for scheduling classes, events, and other activities.
How to Get There
Open the dashboard.
In the left-hand menu, click Location.
Click the + New Location button (or equivalent action) in the top-right corner.
You are now on the Create Location screen.
Step-by-Step Guide
1. Enter the Location Name
Field | Required | What to Enter |
Name | Yes | A short, descriptive name for this location. For example: “Hall #1”, “Spin Room”, or “Outdoor Area”. This is how the location will appear throughout the system. |
Type the name into the Name field.
The placeholder text shows “Ex: Hall #1” to give you an idea of what to write.
Keep it simple and recognisable — staff will see this name when they book rooms or schedule classes.
2. Select a Gym
Field | Required | What to Enter |
Gym | Yes | The gym (business/facility) this location belongs to. Pick one from the dropdown list. |
Open the Gym dropdown.
Choose the gym that this location is part of.
The dropdown automatically defaults to the gym you currently have selected in the dashboard. If that is the correct one, you do not need to change it.
If you manage more than one gym, make sure you pick the right one — a location can only belong to one gym.
Note: The Gym field only appears when you are creating a new location. If you are editing an existing location, the gym cannot be changed.
3. Save
Click the Create button at the bottom-right of the form.
The system will:
Validate that the name is filled in and a gym is selected.
Send the new location to the server.
Redirect you back to the locations 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 (name is required, gym is required)
|
v
API call: LocationsService.create({ body: { name, gymId } })
|
v
Location record is created on the server
|
v
Success notification appears ("Create success!")
|
v
You are redirected to /locations (the locations list)
Troubleshooting
“The Create button does nothing when I click it”
Make sure the Name field is not empty. It is required.
Make sure a Gym is selected. If the dropdown is empty or shows an invalid value, the form will not submit.
Look for small red error messages below the fields — they tell you exactly what needs to be fixed.
“I do not see any gyms in the dropdown”
You must have at least one gym set up in the system before you can create a location.
If you are new to the platform, go to the Gym settings and create a gym first.
If you have gyms but the list is empty, try refreshing the page. The gym data loads when the page opens.
“I got a red error message after clicking Create”
A red alert box will appear at the top of the form with details about what went wrong.
Common causes: a location with the same name may already exist at that gym, or there was a server timeout.
Read the error message carefully. If it is unclear, try again in a moment. If the problem persists, contact your administrator with the exact error message.
“I want to assign this location to a different gym after creating it”
The gym cannot be changed after a location is created. The Gym field only appears during creation.
If you picked the wrong gym, you will need to delete the location and create a new one under the correct gym.
“The form defaulted to the wrong gym”
The Gym dropdown automatically selects the gym you currently have active in the dashboard (the one shown in the top navigation).
To change it, simply open the dropdown and pick a different gym before saving.
If you want the default to be correct next time, switch to the desired gym in the dashboard header before opening the Create Location screen.
“My new location does not appear in the locations list”
After creating, you should be redirected to the locations list automatically. If you do not see it, try refreshing the page.
Make sure you are viewing the correct gym in the dashboard — the locations list may be filtered by the currently selected gym.
“I accidentally created a duplicate location”
Go to the locations list, find the duplicate, and delete it.
The system does not prevent duplicate names, so double-check the list before creating a new location if you are unsure whether it already exists.