What this page is for
This is where selling prices are set. A price change targets one price list and holds a new price for each variant (size, pack or flavour) that changes. It is saved as a draft; when it is ready you submit it, and a second person approves it before any price moves. See Price changes for what happens after you save.
The same page edits a draft you saved earlier (Edit draft on the change). Once a change has been submitted its lines are fixed, and the page says so.
The heart of the page is the New prices grid: every item on the chosen list, with its Price now and an empty New price box. You type, paste or upload only the prices that change. It handles a supermarket of thousands of products as easily as one price.
Only people whose role can set prices see this page.
Before you start
- The price list must exist (Catalogue → Price lists).
- The items must exist (New item). A new variant can be priced before it goes on sale.
Fields
Price list
The list this change prices, such as Retail, Wholesale or Happy hour. Required, and chosen only when the change is new; a saved draft keeps its list. Until you choose it, the grid says Choose the price list first. Prices are typed in that list's currency and its own tax treatment (tax inclusive or exclusive).
Example: Retail
Takes effect
The date and time the new prices start. If that time has already passed when the change is approved, the prices start at the moment of approval instead. Prices are never back-dated.
Example: 5 October 2026, 06:00, before the shop opens.
New price
The new selling price for one variant, in the grid's New price column. Type the amount only, such as 130 or 1250.50, with up to four decimal places. Leave the box empty for anything that does not change: an empty box is not part of the change.
As you type, the grid shows the percentage difference from the price now. It marks a box Not a price when the amount cannot be read, and Same as now, not saved when it equals the current price. A variant that is not on sale yet carries a Not on sale tag; you can still price it.
If the change also prices modifier answers or alternatives in a combo, they appear under Supplements below the grid, each with its own New price. Change one there, or remove the line.
Example: Jogoo Maize Meal — 2 kg packet, Price now KES 210.00, New price 225.
How to…
How to raise a price change
- On Catalogue → Price changes, press Raise a price change.
- Choose the Price list and set Takes effect.
- Find the items in the grid and type each New price.
- Press Save draft.
- On the change's page, check the lines and press Submit for approval. Someone else approves it.
How to find the items to price
- Type in the search box: it matches the name, SKU (stock-keeping unit), item code, or a barcode exactly.
- Choose a category in All categories.
- Tick Show only changed to review just the prices you have typed.
- The grid shows 100 items a page; use the page buttons below it.
How to move quickly through the grid
Press Enter or the down arrow to go to the next row's New price, and the up arrow to go back, as in a spreadsheet.
How to paste a column of prices
Copy a column of prices from a spreadsheet, click the New price box of the first row you want, and paste. The prices fill that row and the rows after it, on to the next pages if needed. If you paste more prices than there are rows, the grid tells you how many were left over.
How to change many prices by a percentage
- Narrow the grid with the search or category to the items you want (or tick Show only changed to adjust only what you have typed).
- Type the percentage in the box with the % sign, such as
5for a 5% rise or-10for a 10% cut. - Press Apply to … items. Every matching item with a current price gets a new price, rounded to the currency. Items with no current price are left as they were, and the grid tells you how many.
How to price in Excel and upload the sheet
- Narrow the grid if you want only some items, then press Download sheet. You get
tulindo-prices.xlsxwith a row per variant and an empty new_price column. - Fill in new_price for the rows that change. Leave the others empty. Do not change the item_variant_id or sku columns: they say which variant each row is.
- Press Upload sheet and choose the file. Nothing is saved yet: the grid fills in the new prices and lists any rows it could not use, by row number, with the reason.
- Review the prices, then press Save draft.
A sheet may carry up to 10,000 new prices, and the grid works on up to 10,000 matching items at once. If the grid says Only the first 10,000 matching items were reached, narrow the search or category and do the rest in a second pass.
Worked examples
Supermarket
Tumaini Supermarket's flour supplier puts prices up by 7%. The buyer chooses Price list Retail, Takes effect Thursday, 06:00, chooses Flour and grains in the category list, types 7 in the percentage box and presses Apply to 38 items. She checks a few with Show only changed, corrects Jogoo Maize Meal — 2 kg packet to a round 225, and saves the draft. For the 1,200 household goods the head office reprices every quarter, she instead downloads the sheet, lets head office fill in new_price, uploads it, and saves.
Butchery that also roasts meat
Mama Njeri's Butchery raises beef from KES 650 (Kenyan shillings) to KES 700 a kilo. On the Retail list she types 700 beside Beef (steak cut) — Per kg, and 420 and 800 beside Nyama choma — Half kg and Full kg, so the roast keeps pace with the raw meat.
Restaurant and bar
The Acacia Grill & Bar prices a new spirit before it goes on sale. On the Bar list, Jameson Irish Whiskey — 1 litre bottle and Jameson tot — 25 ml both carry the Not on sale tag because they are not on sale yet. The manager types 6500 for the bottle and 250 for the tot, sets Takes effect to now, and saves. Once approved and put on sale, both sell at the right price from the first pour.
Salon or car wash
Sparkle Car Wash & Salon has one list. For the December rush the manager searches wash, types 600 beside Full car wash — Saloon car and 900 beside Van or SUV, sets Takes effect to 1 December 2026, 00:00, and raises a second change for 2 January 2027 that puts them back.