What This Screen Does

This is your staff directory — a single place to see everyone who works at your gym or location. Think of it like a digital roster board. You can search for employees, filter them by role or status, sort the list, and jump into any employee’s profile to view or edit their details. You can also create new employees from here.

How to Get There

Open the dashboard.
In the left-hand menu, click Employee.
You are now on the Employee List screen.

Step-by-Step Guide

1. View the Employee Table

When the page loads, you will see a table with the following columns:

Column	What It Shows
Name	The employee’s avatar, full name, and email address.
Roles	Colored chips showing every role assigned to the employee (e.g. Coach, Owner, Receptionist).
Phone number	The employee’s phone number.
Employee groupe	Chips showing which employee groups the person belongs to (e.g. “Morning Shift”, “Trainers”).
Actions	A three-dot menu (⋮) with options for that employee.

2. Filter by Role

At the top of the card you will see a row of tabs, one for each role.
Each tab shows the role name and a count of how many employees have that role.
Click a tab to show only employees with that role.
The All tab shows every employee regardless of role.
Only roles that have at least one employee will appear as tabs.
Available role tabs include: All, Owner, Box manager, Personal trainer, Coach, Floor manager, Bookkeeper, Receptionist, Cleaner, Support, and Member.

3. Search by Name

Below the tabs you will find a Search text field.
Start typing an employee’s name or email.
The table updates automatically as you type — no need to press Enter.
To clear the search, delete the text in the field.

4. Filter by Status

Next to the search field there is a Status dropdown.
Choose one of three options:

Option	What It Shows
All	Every employee, whether active or inactive.
Active	Only employees who are currently active. This is the default.
Inactive	Only employees who have been deactivated.

5. Filter by Employee Group

Next to the status dropdown there is an Employee Groups dropdown.
Click it and select one or more groups.
The table will show only employees who belong to the selected group(s).
To remove the filter, deselect all groups.

6. Sort the Table

Click any column header (Name, Roles, Phone number, Employee groupe) to sort the table by that column.
Click the same header again to toggle between ascending (A → Z, smallest first) and descending (Z → A, largest first) order.
A small arrow on the header indicates the current sort direction.

7. View an Employee’s Profile

Click anywhere on an employee’s row to open their detail page.
Alternatively, click the three-dot menu (⋮) on the right side of the row and select View.

8. Edit an Employee

Click the three-dot menu (⋮) on the employee’s row.
Select Edit.
You will be taken to the employee edit screen where you can change their information.

9. Delete an Employee

Deleting is handled through the bulk action toolbar (see step 10) or programmatically through the row action.
A confirmation dialog will appear asking: “Are you sure want to delete?”
Click Delete to confirm, or close the dialog to cancel.
Once deleted, the employee is removed and the list refreshes automatically.

10. Bulk Actions

When one or more employees are selected, a toolbar appears above the table with the following actions:

Action	Icon	What It Does
Send	Paper plane	Sends a communication to the selected employees.
Download	Download arrow	Downloads information about the selected employees.
Print	Printer	Opens a print dialog for the selected employees.
Delete	Trash bin	Opens a confirmation dialog to delete all selected employees at once.

11. Create a New Employee

Click the + New Employee button in the top-right corner of the page.
You will be taken to the Create Employee screen.

12. Change Pagination Settings

At the bottom of the table you will find pagination controls.
Rows per page: Choose how many employees to show on one page (e.g. 5, 10, 25).
Use the page arrows to move between pages.
Toggle Dense to switch between a compact view (smaller rows) and a comfortable view (taller rows).

What Happens Behind the Scenes

Page loads
    |
    v
Read URL query parameters (page, rowsPerPage, orderBy, order, status, search, roles, groups)
    |
    v
API call: getStaff({ pageSize, pageNumber, sortBy, direction, isActive, searchString, roles, employeeGroupIds })
    |
    v
API call: getGroups() — fetches available employee groups for the filter dropdown
    |
    v
Table populates with employee data and stats (role counts for tabs)
    |
    v
Any filter/sort/page change:
    |
    v
URL query parameters update (so you can bookmark or share the current view)
    |
    v
API call: getStaff({ ...updated filters }) — fetches fresh data
    |
    v
Table re-renders with new results

When you delete an employee:

You click the three-dot menu → Delete (or bulk delete)
    |
    v
Confirmation dialog appears
    |
    v
You click "Delete"
    |
    v
API call: EmployeesService.deleteEmployee({ id })
    |
    v
Employee is removed from the system
    |
    v
API call: getStaff({ ... }) — list refreshes automatically

Troubleshooting

“I cannot find the employee I am looking for”

Make sure the Status filter is set to the correct value. If the employee is inactive, select Inactive or All from the status dropdown.
Check that no role tab is selected that would exclude the employee. Click the All tab to see everyone.
Clear the Employee Groups filter — the person may not be in the group you have selected.
Clear the Search field and try again with a different spelling.
Make sure you have the correct gym/location selected in the dashboard header. Employees are tied to specific locations.

“The table is empty and shows no results”

This can happen when your filters are too narrow. Reset all filters: click the All tab, clear the search field, set status to Active, and deselect all employee groups.
If it is still empty, your location may not have any employees yet. Click + New Employee to add the first one.
Try refreshing the page — there may have been a temporary connection issue when loading the data.

“The role tabs are missing or I only see a few of them”

Tabs only appear for roles that have at least one employee. If no one has the “Cleaner” role, that tab will not show up.
This is normal behavior. Once you assign that role to an employee, the tab will appear automatically.

“I clicked Delete but the employee is still in the list”

Make sure you confirmed the deletion in the dialog by clicking the red Delete button.
If you closed the dialog without confirming, the employee was not deleted.
If you confirmed but the employee is still there, try refreshing the page. A network issue may have prevented the deletion from completing.
Check your permissions — you may not have the right role to delete employees.

“The page is slow or takes a long time to load”

If you have a large number of employees, try reducing the Rows per page setting at the bottom of the table (e.g. from 25 to 10).
Make sure your internet connection is stable.
Close other browser tabs that may be using a lot of memory.

“I changed filters but the URL did not update”

The URL updates automatically every time you change a filter, sort, or page. If it does not, try using a modern browser (Chrome, Firefox, Edge, or Safari).
Note that the URL uses query parameters like ?status=active&search=John — you can bookmark this URL to return to the same filtered view later.

“I want to print or download the employee list but the buttons do nothing”

The Send, Download, and Print buttons in the bulk action toolbar only appear when you have selected one or more employees.
Make sure employees are selected (checkboxes checked) before using these actions.

“I accidentally deleted an employee”

Employee deletion is permanent. If you accidentally deleted someone, you will need to re-create their profile using the + New Employee button.
To avoid accidental deletions, always read the confirmation dialog carefully before clicking Delete.