Selling
Substitutions: Out-of-Stock Items on Pickup and Delivery Orders
Let shoppers say what to do if an item is out of stock when their pickup or delivery order is picked, record what was found on the order, and settle any price difference: refunds go back on your own payment account, and a dearer substitute is never charged without the shopper's approval.
Overview
A shelf count is never perfect. When you pick a pickup order or an order you deliver yourself and something has run out, substitutions decide what happens, without a phone call:
- At checkout the shopper chooses, item by item: a similar item, this item instead (one they name), or refund it.
- When you pick the order, you record on the order page how many of each item you found and, for the rest, what you put in its place.
- The difference is settled for you. A missing item or a cheaper substitute is refunded on your own payment account. A dearer substitute is never charged above what the shopper paid unless they approve it, and even then they pay the difference themselves on a link.
- The shopper is emailed every change, and texted too when they agreed to texts from your store.
Substitutions come with the Grocery & specialty food business type, on any plan. Once a store has them, switch them on or off in Settings → Features. They are for pickup orders and orders you deliver yourself; a parcel shipped by a carrier is not picked to order.
Step 1: Choose how substitutions work
Go to Settings → Substitutions (/settings/substitutions):
| Setting | What it does |
|---|---|
| Ask shoppers at checkout | Turns the choice on at checkout. Off until you turn it on. |
| If the shopper does not choose | Substitute a similar item, or refund the item. |
| Let shoppers name the item they want instead | The shopper can pick a product from the same category on your store. |
| When a substitute costs more | Ask the shopper first (they approve or decline on a link), or give it at the price they paid (you cover the difference). |
| Time the shopper has to answer | From 1 to 72 hours. |
What the shopper sees at checkout
On a pickup order, or when they choose your own local delivery, checkout shows If an item is out of stock with a choice for each item. "This item instead" lists other products of the same category that you have on sale and in stock. The packing slip prints each choice under the item, for whoever picks the order.
Step 2: Record what was picked
Open the order. In the Substitutions section, each item still to hand over shows the shopper's choice (or your default). For an item that was short:
- Change Found to how many you found (0 if none).
- If the shopper allows a substitute, search for the product you are putting in its place and set how many. Leave it empty to refund what is missing.
- Click Review. It shows, line by line, what each substitute is charged, what you cover, what goes back to the shopper, and which lines are put to the shopper first.
- Click Record and tell the customer.
Everything that needs no answer is settled in one change to the order: the missing items come off, the substitutes go on, stock moves with them, tax is worked out on the change only, and the refund goes back to the card (or the way they paid) on your own payment account. The shopper gets one "Your order was updated" email. The order's edit history shows the change.
Substitutions are recorded while the order is being picked: before it is marked ready for pickup or handed to a driver. Items sold by weight or measure are not substituted here; refund the amount that is short from the order instead. If the shelf really is empty, correct the stock count in Inventory: taking an item off an order puts its units back on the count.
The price rules
| Substitute | What happens |
|---|---|
| Costs the same or less | It goes on at its price. The difference (with its tax) is refunded. |
| Costs more, setting give it at the price they paid | It goes on at the price they paid for the missing items. You cover the difference. If tax on the substitute would still add to their total, its price is lowered until it does not. |
| Costs more, setting ask the shopper first | Nothing changes yet. The shopper gets an email (and a text, if they agreed to texts) with a link to approve or decline. |
| Not the item the shopper named | Put to the shopper first, whatever it costs. |
| The shopper chose refund it | No substitute can be recorded; what is missing is refunded. |
When you asked the shopper
The line shows Waiting for the customer until they answer, and you get a notification when they do:
- Customer approved: click Add the substitute (customer pays the difference). The substitute goes on at the price they saw, and they are sent a link to pay the difference. Nothing is taken from their card without it.
- Customer declined: click Refund the item.
- No answer in time: refund the item, or give the substitute at the price they paid.
Cancel withdraws the question; nothing on the order had changed.
Who can do what
Recording substitutions needs access to orders. Settling a line that refunds money or asks the shopper for the difference, or gives a substitute below its catalogue price, also needs access to finance and, for team members who use two-step sign-in, a fresh code, the same as editing a paid order.