What This Screen Does
This is where you view all the details about a single product. Think of it like opening a product’s profile card — you can see its photos, name, price, stock status, description, sales history, and inventory entries. From here you can also edit the product, make stock corrections, view the audit log, and export inventory data.
How to Get There
Open the dashboard.
In the left-hand menu, click Products.
Click on any product in the list.
You are now on the Product Details screen.
Step-by-Step Guide
1. Toolbar Actions
At the top of the screen you will find a toolbar with several buttons:
Action | Icon | What It Does |
Back | Left arrow | Takes you back to the product list. |
Audit Log | Audit icon | Opens a dialog showing a history of all changes made to this product (who changed what and when). |
Stock Correction | Inventory box icon | Opens the stock correction dialog and switches to the Inventory tab. Only visible if the product has stock tracking enabled. |
Edit | Pen icon | Takes you to the product edit screen where you can modify the product’s details. |
2. View Product Images
On the left side of the screen you will see a photo carousel (if the product has images).
Use the left and right arrows to browse through the images.
Click on any image to open it in a lightbox (a full-screen viewer).
Below the main image you will see thumbnail previews. Click a thumbnail to jump to that image.
If the product has no images, the carousel area will not appear.
3. View Product Summary
On the right side of the screen you will see the product’s key information:
Field | What It Shows |
Stock Status | A colored label at the top — in stock (green), low stock (orange), out of stock (red), or Not tracked (grey) if stock tracking is disabled. |
Product Name | The name of the product in large text. |
Price | The selling price, formatted in the product’s currency. |
Short Description | A brief description of the product shown below the price. |
Total Inventory | The total number of units in stock. |
Average Cost Price | The average cost price per unit. |
Share | A link to share the product (copy or send). |
Stock status is calculated automatically:
Out of stock — available quantity is zero or less.
Low stock — available quantity is 30% or less of total quantity.
In stock — available quantity is above 30% of total quantity.
4. Browse the Tabs
Below the product summary there is a card with three tabs. The Sales tab is selected by default.
Tab | What It Shows |
Description | The full product description rendered as formatted text (Markdown). |
Sales | A table of all purchase transactions for this product. |
Inventory | A table of all stock entries (deliveries, corrections, etc.) for this product. |
You can switch between tabs by clicking on the tab label.
5. Description Tab
Displays the product’s full description as formatted text.
This content is read-only on this screen. To change it, click the Edit button in the toolbar.
6. Sales Tab
Shows a paginated table of all sales (purchases) for this product.
Column | What It Shows |
Customer | The name of the customer who bought the product. |
Date | When the purchase was made. |
Quantity | How many units were purchased. |
Price | The price paid. |
Actions | Click to view the related invoice. |
You can sort the table by clicking on any column header. By default it is sorted by date (newest first).
Use the pagination controls at the bottom to navigate between pages or change how many rows are shown per page.
Toggle Dense mode for a more compact table layout.
7. Inventory Tab
Shows a paginated table of all stock entries for this product.
Column | What It Shows |
Origin | Where the stock entry came from (e.g. delivery, correction, sale). |
Date | When the stock entry was recorded. |
Invoice | The related invoice number, if applicable. |
Quantity | The number of units added or removed. |
Cost Price | The cost price associated with this entry. |
You can sort the table by clicking on any column header. By default it is sorted by date (newest first).
Use the pagination controls at the bottom to navigate between pages or change how many rows are shown per page.
Toggle Dense mode for a more compact table layout.
8. Export Inventory Data
When you are on the Inventory tab, a three-dot menu (⋮) appears on the right side of the tab bar.
Click it, then click Export.
The system will download all inventory entries as a CSV file named
result.csv.The export includes all entries (not just the current page).
9. Stock Correction
Click the Stock Correction button (inventory box icon) in the toolbar.
The screen will automatically switch to the Inventory tab.
A Stock Correction Dialog will open.
Select the stock lot you want to correct, enter the new quantity, and confirm.
This option is only available if the product has stock tracking enabled.
What Happens Behind the Scenes
You open the Product Details screen
|
v
API call: getProduct(id) — loads the product data
|
v
API call: getChainSettings() — loads chain settings (if not already loaded)
|
v
Product data is displayed (images, summary, tabs)
|
v
Sales tab loads by default:
API call: getProductPurchases({ id, pageSize, pageNumber, sortBy, direction })
|
v
(If you switch to the Inventory tab)
API call: getProductStockEntries({ id, pageSize, pageNumber, sortBy, direction })
API call: getProductStockLots({ id, pageSize: -1 })
|
v
(If you click Export on the Inventory tab)
API call: GET /api/products/{id}/stock/entries (Accept: text/csv, all entries)
|
v
CSV file is downloaded as "result.csv"
Troubleshooting
“The page just shows a loading skeleton and never finishes”
The product data is being fetched from the server. If it stays loading, check your internet connection.
Try refreshing the page.
If the problem persists, the server may be temporarily unavailable. Wait a moment and try again.
“I see an error message instead of the product”
This means the product could not be loaded. The error message on screen will explain what went wrong.
The product may have been deleted by another user.
The product ID in the URL may be incorrect. Click the Back to List button to return to the product list and try again.
“I cannot find the Stock Correction button”
The Stock Correction button only appears if the product has stock tracking enabled.
If the product’s stock is not tracked, you will see “Not tracked” in the summary area and the button will be hidden.
To enable stock tracking, click Edit and turn on the stock tracking setting for this product.
“The Export option is not visible”
The Export button (three-dot menu) only appears when you are on the Inventory tab.
Switch to the Inventory tab and the menu will appear on the right side of the tab bar.
The Description and Sales tabs do not have an export option.
“The exported CSV file is empty or contains no data”
If the product has no stock entries, the CSV will have column headers but no data rows.
Make sure you are looking at the right product — check the product name at the top of the page.
If you expected data but the file is empty, try refreshing the page and exporting again.
“I clicked on a sale but nothing happened”
Clicking a row in the Sales tab opens the related invoice details page.
If the invoice has been deleted or the link is broken, the page may not load. Go back and try again.
Check that you have permission to view invoices.
“The images are not loading”
Product images are loaded from the server. If they do not appear, check your internet connection.
The image files may have been removed from the server. Ask your administrator to re-upload them.
Try refreshing the page. If the product has no images, the carousel section will simply not appear.
“I want to edit the product but cannot find how”
Click the Edit button (pen icon) in the toolbar at the top of the screen.
This will take you to the product edit screen where you can change all fields.
If the Edit button is not visible, you may not have permission to edit products. Contact your administrator.