Products

The Products List

The Products page shows every product in a searchable table. The number beside the title is your product count, and the search box filters by name, code, or category as you type.

Each row shows:

• Name, with its short description underneath and a Variants badge (and count) if the product has variants.
• Code (the product or barcode value).
• Category.
• Price.
• Stock, with an amber Low badge at 5 units or fewer and a red Out badge at zero. Products with variants show the combined stock across all variants.
• Status (Active or Inactive).

Use the column visibility menu (the columns icon above the table) to also show:

• Unit (the unit of measure, such as kg, L, or ea).
• Cost Price and Margin (Admins only). Margin is green when positive and red when you are selling below cost. These are hidden by default to keep the table clean.

On each row, Admins have action icons to manage variants, adjust stock, edit, and delete the product. When your store belongs to a multi-branch organization, a branch stock icon also appears (see Multi-Branch (Organizations)).

Adding a Product (Admin Only)

1. Go to Products from the sidebar.
2. Click "Add Product".
3. Fill in:
   • Name (required)
   • Category (required: see Product Categories)
   • Unit of Measure (Each, Kilogram, Litre, and so on: see Units of Measure)
   • Product Code (a code is filled in for you, and you can change it. Set it to the barcode printed on the item so it can be scanned at the POS.)
   • Selling Price (what the customer pays; for items sold by weight or volume this is the price per unit, for example per kg)
   • Cost Price (optional, for margin tracking, never shown to cashiers: see Cost Price & Margin)
   • Initial Stock (the quantity you currently hold)
   • Tax Class (shown only when the tax module is on; leave it as the store default unless this product is taxed differently: see Tax Module)
   • Description (optional)
   • Returnable, with an optional custom return window (see Returns Policy)
   • Promotion eligible (on by default; turn it off to exclude this product from every promotion: see Promotions)
4. Click Save.

Editing a Product

Click the Edit (pencil) icon on any product row. You can change the name, category, unit of measure, code, selling price, cost price, tax class, and description, and toggle Returnable, Promotion eligible, and Active.

Stock is not changed here

The Stock field in the edit form is locked (it shows a small padlock). To change stock, use Stock Adjustments instead, which records a full history of every change. See below.

To remove a cost price you set earlier, clear the Cost Price field and save.

Deactivating a Product

Toggle the product's Active status off. Inactive products are hidden from the POS and barcode lookups, but their sales history is preserved.

Products with Variants

For products that come in multiple sizes or colours, see Product Variants. The Stock column for variant products shows the combined total across all active variants.

Stock Adjustments and History

To change stock or review how it has changed, click the Adjust stock icon on a product row. The dialog has two tabs: Adjust (add or remove stock) and History (every past change, what type it was, the resulting stock level, and who made it). See Stock Adjustments.

Checking Stock in Other Branches

If your store is part of a multi-branch organization, a branch stock icon appears on product rows. Managers and Admins can use it to check the same product's stock at sister branches. See Multi-Branch (Organizations).

---

FAQ

Q: Why can't I find a product at the POS?

A: The product may be deactivated or out of stock. Check the Products page and verify its status.

Q: Can I sell a product that is out of stock?

A: No. The system will show an error if there is insufficient stock.

Q: Can I sell an inactive product?

A: No. Products must be marked as active.

Q: Can a Cashier manage products?

A: No. Only Admins can create, edit, or manage products. Managers can view products but not change them.

Q: Can I change a product's stock from the edit form?

A: No. The Stock field in the edit form is locked. Use the Adjust stock icon on the product row instead. It records every change with a reason and keeps a full history of who adjusted stock and when.

Q: If I change a product's price, does it affect old sales?

A: No. Each sale saves a snapshot of the price at the time of the transaction. Past records are never altered.