What This Screen Does
This is where you see all the products in your system at a glance. Think of it like the shelves in a store — every item you sell is listed here with its name, price, stock level, and when it was added. From this screen you can search for products, filter them by category, create new ones, edit existing ones, correct stock, or remove products you no longer need.
How to Get There
Open the dashboard.
In the left-hand menu, click Product.
You are now on the Product List screen.
Step-by-Step Guide
1. Understand the Page Layout
When the page loads you will see:
Breadcrumbs at the top showing Dashboard > Product > List.
Two buttons in the top-right corner: Categories and New Product.
A category tabs bar just below the card header.
A search bar for finding products by name.
A table listing all your products.
Pagination controls at the bottom of the table.
2. Filter by Category
The tab bar shows All plus every product category that has at least one product.
Each tab displays a count badge showing how many products belong to that category.
Click a tab to show only products in that category.
Click All to return to the full list.
3. Search for a Product
Type a product name (or part of it) into the Search… text field.
The table updates automatically as you type.
To clear the search, delete the text in the search field.
4. Read the Product Table
Each row in the table shows the following:
Column | What It Shows |
Product | The product image, name, and category name. |
Created at | The date and time the product was added to the system. |
Stock | A progress bar and label showing stock status: in stock, low stock, out of stock, or Not tracked. The actual available quantity is shown when stock tracking is enabled. |
Price | The product’s price in its configured currency. |
Actions | A three-dot menu (⋮) with options for this product. |
5. Sort the Table
Click on a column header (Product or Created at) to sort by that column.
Click the same header again to reverse the sort direction (ascending ↔︎ descending).
The Stock and Price columns are not sortable.
6. Change Page Size and Navigate Pages
At the bottom of the table, use the Rows per page dropdown to choose how many products to show per page (e.g. 5, 10, 25).
Use the page arrows to move between pages.
Toggle the Dense switch to make rows more compact.
7. View a Product
Click the product name in the table, or
Click the ⋮ menu on the row and select View.
You will be taken to the product details page.
8. Edit a Product
Click the ⋮ menu on the product row.
Select Edit.
You will be taken to the product edit page.
9. Correct Stock for a Product
Click the ⋮ menu on the product row.
Select Stock correction.
You will be taken to the product details page with the stock correction panel open.
10. Delete a Product
Click the ⋮ menu on the product row.
Select Delete.
A confirmation dialog will appear asking: “Are you sure want to delete?”
Click Delete to confirm, or close the dialog to cancel.
After deletion, the product list refreshes and you will see a green “Product removed!” notification.
11. Navigate to Categories
Click the Categories button in the top-right corner.
You will be taken to the Product Categories management screen.
12. Create a New Product
Click the New Product button in the top-right corner.
You will be taken to the product creation form.
What Happens Behind the Scenes
Page loads
|
v
Read URL query params (search, categoryId, page, rowsPerPage, orderBy, order)
|
v
API call: ProductsService.getProducts({ searchString, pageNumber, pageSize, sortBy, direction, productCategoryId })
|
v
API call: ProductCategoriesService.index()
|
v
Product list and categories are loaded into the table
|
v
(When you search or change filters)
URL query params are updated in the browser address bar
|
v
API call: ProductsService.getProducts({ ...updated params })
|
v
Table refreshes with new results
|
v
(When you delete a product)
API call: ProductsService.deleteProduct({ id })
|
v
API call: ProductsService.getProducts({ ...current params })
|
v
Table refreshes, "Product removed!" notification appears
Troubleshooting
“I do not see any products in the list”
If the table is empty, check whether you have a category tab selected that has no products. Click the All tab to see everything.
Make sure the search field is empty. A leftover search term might be hiding your products.
Verify that products have been created in the system. If you are new, click New Product to add your first one.
“My search is not finding the product I am looking for”
The search only matches against the product name. It does not search descriptions or categories.
Try typing just the first few letters of the product name.
Check for typos in your search term.
“The stock column says ‘Not tracked’ for my product”
This means stock tracking is disabled for that product. The system will not show a quantity or progress bar.
To enable stock tracking, click Edit on the product and turn on the Track Stock option.
“I accidentally deleted a product”
Product deletion is permanent. There is no undo.
If you need the product back, you will need to create it again using the New Product button.
To avoid accidental deletions, always read the confirmation dialog carefully before clicking Delete.
“The page is showing loading skeletons and never finishes”
This usually means the products API is taking too long or has failed.
Check your internet connection and try refreshing the page.
If the problem persists, contact your administrator — the server may be experiencing issues.
“I changed the gym/location but the product list did not update”
The product list automatically refreshes when you switch the selected gym in the dashboard. Give it a moment.
If it still shows old data, try refreshing the page manually.
“The category tabs are missing some categories”
Only categories that contain at least one product appear as tabs. Empty categories are hidden.
If you just created a category, add a product to it first, and then it will show up in the tabs.
“My URL keeps changing as I use the page”
This is expected behavior. The page saves your current filters, sorting, and pagination into the URL query parameters so that you can bookmark or share the exact view you are looking at. Refreshing the page will restore your filters.