Skip to content
Documentation sections
Orders & Shipping

Commerce Settings

What this screen is for

The screen where a business sets its shipping fee, free-shipping threshold, collection window, minimum order total, maximum quantity per product, and return window. All nine of these fields are constants the server's order-acceptance and return logic reads — but since online ordering isn't open to customers yet, none of them governs anything today.

When you would use this

A business owner comes here to set a shipping fee, a minimum order total or a return policy ahead of time; these settings can be made today, but none of them applies to any order until online ordering opens.

Who sees it

Only the user matching the owner field on the business document can open this screen.

Where it lives

The screen exists on both the mobile app and the web panel; both write the same nine fields to the same document — neither is an incomplete copy of the other. This was a gap the owner reported (2026-08-17): the panel had the screen and mobile didn't. That's the gap this closed.

What you can do here

Turn shipping on/off, and the default fee

A switch turns shipping on or off; while on, a shipping fee is entered as the default amount.

Free-shipping threshold

A subtotal above which shipping becomes free; left empty, the business never ships for free.

Collection window

Entered as a number of days for how long a ready order is held; zero means the business holds it indefinitely.

Minimum order total

A switch turns this limit on or off; while on, an order whose subtotal falls under it is refused.

Maximum quantity per product

A switch turns this limit on or off; while on, the limit must be at least 1.

Return window

Entered as a number of days a delivered order may be returned within; zero means the business accepts no returns at all.

Save

All nine fields are written in one save; the form does not proceed if a numeric field cannot be parsed or is invalid.

What the server accepts and refuses

An empty free-shipping threshold does not mean zero

Leaving the field empty writes null to the document; null means "never free shipping", while zero would have meant every order ships free — mixing the two puts the cost on the wrong side.

This save never touches the showcase list

The list of featured products lives on the same document, in a separate field this screen doesn't write to; this screen's save merges into the document without touching that field, rather than overwriting it.