What This Screen Does
This is where you see all your product categories in one place. Think of it like a filing cabinet where each drawer is labelled with a category name — “Supplements”, “Apparel”, “Drinks”, and so on. From here you can search for a category, create a new one, or open an existing one to make changes.
How to Get There
Open the dashboard.
In the left-hand menu, click Product categories.
You are now on the Product Categories List screen.
Step-by-Step Guide
1. Browse the Category Table
When the page loads, the system fetches all product categories for your currently selected gym and displays them in a table.
Column | What It Shows |
Category | The name of the product category. |
Publicly available | Shows Yes if the category is visible to the public, or No if it is internal only. |
Created at | The date and time the category was created (e.g. “15 Jan 2025, 09:30”). |
Actions | A three-dot menu (⋮) that lets you perform actions on that row. |
The table supports sorting. Click any column header to sort the list in ascending or descending order.
Use the pagination controls at the bottom of the table to move between pages and change how many rows are shown per page.
Toggle Dense at the bottom-right to switch between a compact and a comfortable row height.
2. Search for a Category
At the top of the table you will see a Search bar.
Start typing a category name. The table updates as you type so only matching categories are shown.
To clear your search, delete the text in the search bar.
3. Filter Results
If you apply filters (for example, by stock or publish status), a filter chip bar appears below the search bar showing your active filters.
Click the X on any chip to remove that single filter.
Click the Clear button to remove all filters at once and go back to the full list.
The bar also shows how many results match your current filters.
4. Create a New Category
Click the New category button in the top-right corner of the page.
You will be taken to the Create Product Category screen where you can fill in the details.
5. Edit a Category
Find the category you want to change in the table.
Click the three-dot menu (⋮) on the right side of that row.
Click Edit.
You will be taken to the Edit Product Category screen for that category.
6. Delete Categories (Bulk Action)
Select one or more categories using the checkboxes (if available).
A blue action bar appears above the table showing how many items are selected.
Click the trash bin icon in that bar.
A confirmation dialog will appear asking: “Are you sure you want to delete X items?”
Click Delete to confirm, or close the dialog to cancel.
7. Extra Actions (Print, Import, Export)
Next to the search bar, click the three-dot menu (⋮).
You will see three options:
Action | What It Does |
Sends the category list to your printer. | |
Import | Lets you import categories from an external file. |
Export | Lets you export the current category list to a file. |
What Happens Behind the Scenes
You open the Product Categories page
|
v
API call: ProductCategoriesService.index()
|
v
Server returns all categories for the selected gym
|
v
Categories are stored in the app and displayed in the table
|
v
You can search, sort, paginate, or click into any category
You click "Edit" on a category row
|
v
App navigates to /product-categories/:id/edit
|
v
The edit screen loads the details for that category
You select items and click the Delete icon
|
v
Confirmation dialog appears
|
v
You click "Delete"
|
v
Selected categories are removed
|
v
Table refreshes with remaining categories
Troubleshooting
“The table is empty but I know I have categories”
Check which gym / location is selected in the dashboard header. Categories are loaded for the currently selected gym. Switch to the correct gym and the list should appear.
If you just created a category, try refreshing the page — the list fetches data when the page loads.
“The search is not finding my category”
The search matches by name only. Make sure you are spelling the category name correctly.
Clear the search bar and browse the full list to confirm the category exists.
If filters are active (you see coloured chips below the search bar), click Clear to remove them — they may be hiding results.
“The table shows loading skeletons that never go away”
This usually means the API call to fetch categories is taking too long or has failed silently.
Check your internet connection.
Try refreshing the page. If the problem persists, the server may be experiencing issues — contact your administrator.
“I clicked Delete but nothing happened”
The delete confirmation dialog should have appeared. If it did not, try again.
Make sure you have selected at least one category before clicking the trash icon.
If the dialog appeared and you clicked Delete but the items are still in the table, refresh the page and check again.
“I cannot find the New Category button”
The New category button is in the top-right corner of the page, next to the breadcrumb navigation.
If you do not see it, you may not have the required permissions to create categories. Ask your administrator to check your role.
“Sorting does not seem to work”
Click directly on the column header text (e.g. “Category” or “Created at”) to toggle sorting.
An arrow icon appears next to the header to show the current sort direction (ascending or descending).
Sorting is applied to the full dataset, not just the visible page.
“I switched gyms but the list did not update”
The category list should refresh automatically when you change the selected gym. If it does not, refresh the page manually.
Make sure the gym switch completed — check the gym name in the dashboard header.
“The Print / Import / Export options do nothing when I click them”
These features may not be fully configured for your account or may require additional setup.
Contact your administrator to confirm that print, import, and export are enabled for product categories.