What This Screen Does
This is where you see all the locations (rooms, areas, or zones) that belong to your gym. Think of locations as the different spaces inside your facility — for example, “Main Floor”, “Studio A”, or “Outdoor Area”. From this screen you can browse the full list, create a new location, or jump into an existing one to edit it.
How to Get There
Open the dashboard.
In the left-hand menu, click Location.
You are now on the Location List screen.
Step-by-Step Guide
1. Review the Breadcrumb Navigation
At the top of the page you will see a breadcrumb trail: Dashboard → Location → List.
You can click Dashboard to go back to the main dashboard, or Location to return to the location root page.
2. Create a New Location
Click the New button in the top-right corner of the page.
This takes you to the Create Location screen where you can add a new location to your gym.
3. Browse the Location Table
The main area of the screen is a table listing all your locations.
Column | What It Shows |
Name | The name of the location (e.g. “Studio A”, “Main Floor”). |
Actions | A three-dot menu icon that opens additional options for that row. |
The table is sorted by Name in descending order by default.
You can click the Name column header to change the sort direction (ascending or descending).
4. Filter by Tab
Above the table there is an All tab that shows the total number of locations.
Click the All tab to view every location. This is the only filter tab available on this screen.
5. View Filter Results (if active)
If any filters have been applied, a summary bar appears below the tabs showing the number of results found.
Click the Clear button to reset all filters back to their defaults.
6. Change Page Size and Navigate Pages
At the bottom of the table you will find pagination controls.
Use the Rows per page dropdown to choose how many locations appear on each page.
Use the page arrows to move between pages.
Toggle the Dense switch to make table rows more compact, which is helpful when you have many locations.
7. Edit a Location
Option A: Click directly on the location name in the table. This navigates you to the edit screen for that location.
Option B: Click the three-dot menu icon (⋮) on the right side of the row, then select Edit from the popup menu.
8. Delete Locations (Bulk Action)
If you select one or more locations using the selection mechanism, a toolbar appears above the table.
Click the trash icon to open a confirmation dialog.
The dialog asks: “Are you sure you want to delete X items?”
Click Delete to confirm, or close the dialog to cancel.
What Happens Behind the Scenes
You open the Location List screen
|
v
API call: GET /api/locations
(with pageSize, pageNumber, sortBy, direction)
|
v
Server returns the list of locations
+ total count in the "x-total-count" header
|
v
Locations are displayed in the table
|
v
(If you change page, sort, or gym selection)
The same API call fires again with updated parameters
|
v
Table updates with the new data
Troubleshooting
“I do not see any locations in the table”
If the table says “No Data”, it means no locations have been created yet for the currently selected gym.
Click the New button to create your first location.
Make sure you have the correct gym selected in the global gym selector at the top of the dashboard.
“The list does not update after I created a new location”
The list refreshes automatically when you return to this screen. If it does not, try refreshing the page manually.
Check that the new location was saved successfully — you should have seen a success notification on the create screen.
“I cannot find the location I am looking for”
This screen does not have a search field. All locations are displayed in the paginated table.
Check if the location is on another page by using the pagination controls at the bottom.
Verify that you have the correct gym selected — locations belong to a specific gym.
“The sort order seems wrong”
By default, the table sorts by Name in descending (Z-A) order.
Click the Name column header to toggle between ascending (A-Z) and descending (Z-A) order.
“I clicked Delete but nothing actually happened”
The delete confirmation dialog appears, but clicking Delete inside it currently only closes the dialog. Actual deletion depends on your system’s backend configuration.
If locations are not being removed, contact your administrator to verify that the delete functionality is fully enabled.
“I see a number next to the All tab — what does it mean?”
The number inside the All tab badge is the total count of locations across all pages.
This count comes from the server and updates each time the list refreshes.
“The page feels slow or unresponsive”
If you have many locations, try reducing the Rows per page value using the dropdown at the bottom of the table.
Toggling Dense mode on can also help by reducing the visual size of each row.
Check your internet connection — the location data is fetched from the server each time you change pages or sorting.