Pricing
Pricing Configuration
Pricing configuration for every field and option: fixed, percentage, formula, flat fee, or per-quantity. Customers see live totals as they select options.
Pricing types overview
| Type | How it works | Example |
|---|---|---|
| Fixed | A flat amount added to the price | Gift wrap: +£3.00 |
| Percentage | A percentage of the base product price | Insurance: +10% of product price |
| Formula | A math expression using field values and product price | Engraving per character: quantity * 0.50 |
| Flat fee | Fixed price regardless of quantity | Setup fee: always +£10, even if buying 5 items |
| Per quantity | Price multiplied by the cart quantity | Monogram: +£2 per unit in cart |
| None | No price impact | Gift message text: £0.00 |
Fixed pricing
The simplest pricing type. Enter an amount — that amount is added to the product price when this option is selected.
- Used for: gift wrap, engraving, warranty, accessories
- Value: any decimal number (positive to add, negative to discount)
Percentage pricing
The price is calculated as a percentage of the base product price. The add-on price changes if the base product price changes.
- Used for: insurance, extended warranty, handling fee as % of order
- Value: a number representing the percentage (e.g.,
10for 10%)
Example: Product price £50, add-on at 10% → adds £5.00. If the product price is £100, the same add-on adds £10.00.
Formula pricing
Write a mathematical expression using variables. The formula is evaluated in real-time as the customer changes field values.
Available variables
| Variable | Description |
|---|---|
QUANTITY | The product quantity in the cart |
PRICE | The product base price |
FIELD_VALUE | The numeric value of the current field (e.g., character count from a text field) |
Formula examples
# Engrave per character (text field length × £0.50)
FIELD_VALUE * 0.50
# Per-quantity setup fee plus base charge
(QUANTITY * 1.00) + 5.00
# 15% of base price, minimum £2
MAX(PRICE * 0.15, 2.00)Live price preview
As the customer selects options, the product price shown on the page updates in real time. This is handled by the PricePreviewController which calls the POST /saue/v1/price-preview REST endpoint to calculate the total server-side.
- Works with classic and block checkout themes
- Debounced: waits 300ms after the customer stops typing before recalculating
- Shows a loading indicator while calculating
- Falls back gracefully if the REST endpoint is unreachable
Per-option pricing (radio, dropdown, image select, checkbox group)
For multi-option fields, each option can have its own independent price. When a customer selects an option, that option’s price replaces any previous selection’s price.
- Option A: Wood — +£0.00
- Option B: Metal — +£15.00
- Option C: Acrylic — +£8.00