What This Screen Does
This is where you update an existing product in the system. Think of it like opening a product’s file and changing any of its details — the name, price, description, images, or stock settings. Once you save, all the changes go live and customers will see the updated information.
How to Get There
Open the dashboard.
In the left-hand menu, click Product.
Find the product you want to edit and click on it.
Click the Edit button (or navigate directly to the edit screen).
You are now on the Edit Product screen.
Step-by-Step Guide
1. Product Information
This section covers the basic details that customers see when browsing your shop.
Product Name
Field | Required | What to Enter |
Product Name | Yes | The name of the product as it will appear to customers. |
Short Description
Field | Required | What to Enter |
Short Description | No | A brief summary displayed in product listings and previews. You can write a few sentences about the product. This is a multi-line text field. |
Full Description
Field | Required | What to Enter |
Full Description | Yes | Detailed information about the product shown on the product page. This field uses a rich-text editor, so you can format text with bold, italics, lists, and more. |
Product Images
Below the description fields you will see the image uploader.
Click to upload one or more product photos (the first image will be used as the main thumbnail).
Images are cropped to a square (1:1 aspect ratio).
You can upload multiple images at once.
To remove a single image, click the remove button on that image.
To remove all images, click the Remove All button.
You must have at least one image — the form will not save without it.
Note: When editing, removing an image deletes it from the server immediately — this cannot be undone.
2. Inventory & Organization
This section lets you manage stock levels, categorize the product, and configure technical details.
Field | Required | What to Enter |
Product Code | No | An internal reference code for this product. Use whatever coding system your team prefers. |
SKU (Stock Keeping Unit) | No | A unique identifier for inventory tracking. Commonly used in warehouses and point-of-sale systems. |
Initial Quantity | Yes (if enabling stock tracking on a product that did not have it before) | The starting stock quantity for this product. Only appears when you are turning on inventory tracking for the first time. Enter a whole number. |
Product Category | No | Pick a category from the dropdown to organize products for easier browsing. Categories are set up in the Product Categories section. |
Accounting Number | Yes | The account number used for bookkeeping and financial reporting. Enter a number greater than zero. |
Display Order | No | Controls the sort order in product listings. Lower numbers appear first. |
Product Tags
Click the + Add tags field and type a tag name.
Press Enter to add it.
You can add as many tags as you like — they help customers find products through search.
Tags appear as small coloured chips. Click the × on a chip to remove it.
You can also pick from suggested tags that appear in the dropdown.
Toggles
Toggle | Default | What It Does |
Available in Online Shop | On | When enabled, customers can see and purchase this product in the online shop. Turn it off to hide the product from the shop without deleting it. |
Enable Inventory Tracking | On | When enabled, the system tracks stock levels for this product. Warning: Turning this off will permanently delete all prior inventory entries for this product. A confirmation dialog will appear before this happens. |
3. Pricing & Tax
This section is where you set what customers pay and what the product costs you.
Field | Required | What to Enter |
Selling Price | Yes | The price customers will pay for this product. Enter a number (e.g. |
Cost Price | Conditional | Your cost to acquire or produce this product (used for profit calculations). This field only appears if you are disabling inventory tracking or if stock tracking was not previously enabled. When stock tracking is active on an existing product, cost is managed through stock entries instead. |
VAT Rate | Yes | Select the applicable tax rate from the dropdown. You must choose a valid VAT rate — leaving it unset will prevent saving. |
4. Save Changes
When you are happy with your edits, click the Save Changes button at the bottom-right of the screen.
The system will:
Validate all your inputs.
Update the product record with your changes.
Upload any new product images.
Navigate you back to the previous page.
You will see a green “Update success!” notification at the bottom of the screen.
What Happens Behind the Scenes
You click "Save Changes"
|
v
Form validates all fields (Yup schema)
|
v
API call: ProductsService.edit({ id, body: formData })
|
v
Product record is updated on the server
|
v
API call: ProductsService.addImage({ id, files: [images] })
|
v
Product images are synced with the server
|
v
Success notification "Update success!" appears
|
v
You are navigated back to the previous page
Troubleshooting
“I filled everything in but the Save Changes button does not work”
Double-check that all required fields are filled in. The form will not submit if anything is missing.
Look for small red error messages below the fields — they tell you exactly what needs to be fixed.
Make sure you have at least one product image uploaded.
Make sure the Full Description field is not empty — it is required even though it uses a rich-text editor.
Verify that the Accounting Number is a number greater than zero.
“I do not see a Cost Price field”
The Cost Price field is hidden when inventory tracking is enabled on an existing product.
When stock tracking is active, cost prices are managed through individual stock entries instead.
If you need to enter a cost price directly, you must first disable inventory tracking — but be aware this will delete all existing stock entries.
“A warning appeared when I turned off inventory tracking”
This is expected. Disabling inventory tracking permanently deletes all prior inventory entries (stock entries and stock lots) for this product.
Read the confirmation dialog carefully. Click Proceed only if you are sure.
This action cannot be undone. If you are unsure, click the close button to cancel.
“My product images disappeared after removing them”
When editing an existing product, removing an image deletes it from the server immediately.
This happens as soon as you click the remove button — you do not need to save first.
If you removed an image by mistake, you will need to upload it again.
“I do not see any categories in the dropdown”
Categories are loaded when the page opens. If the list is empty, try refreshing the page.
If you have not created any product categories yet, go to the Product Categories section and set one up first.
If the problem persists, check your internet connection — the categories API may be unavailable.
“The VAT rate dropdown shows nothing or an invalid selection”
Make sure your system administrator has configured tax rates in the system settings.
If the product previously had a tax rate that has since been deactivated, it will not be pre-selected. Choose a new active tax rate.
A valid VAT rate is required — the form cannot be saved without one.
“I got an error after clicking Save Changes”
A red error message will appear. Read it carefully — it usually explains the problem.
Common causes include: server timeout, network issues, or a validation rule that was not caught by the front-end form.
Try again after a few moments. If the error persists, contact support with the error message.
“The selling price keeps resetting or looks wrong”
The price field accepts decimal values with commas (e.g.
29,99or29.99depending on your locale).Make sure you are not accidentally entering letters or special characters — the field only accepts numbers.
The currency symbol shown is based on your chain’s default currency setting and cannot be changed on this screen.
“The Initial Quantity field is not showing”
This field only appears when you are enabling inventory tracking for the first time on a product that did not previously have it.
If the product already has inventory tracking turned on, stock quantities are managed through stock entries, not this field.
“My changes were not saved but I did not see an error”
Make sure you clicked the Save Changes button and waited for the loading spinner to finish.
Check your internet connection — if the connection dropped mid-save, the changes may not have reached the server.
Refresh the page and check whether your changes appear. If not, try editing and saving again.