
Adding or editing a market
Click a market to edit it, or add a new one. Each market has the following options.- Name - A label for the market, such as
EuropeorUnited States - Active - Whether the market is available to customers
- Show in Currency Switcher - Lets customers choose this market manually from the storefront currency switcher
- Primary Market - Marks this as your default market. This cannot be changed once you have orders, subscriptions, or customers
- Inventory Location - Where this market’s orders take stock from (see below)
- Payment Provider - The card payment gateway used for the market’s checkout (Stripe or PayFast)
- Timezone - The local time for customers in this market, used when an email is scheduled for a particular day, such as a gift voucher sent on a chosen date. Leave it on Use store default to use your shop’s timezone.
- Currency - The currency the market sells in, for example
EUR - Euro (€) - Exchange Rate - The rate from your base currency, used to convert prices. Fixed at
1.0for the primary market - Rounding Precision - How converted prices are rounded: Round to nearest full unit (10), Round to nearest 10 cents (10.50), or No rounding (10.49)
A country can only belong to one market. If you pick a country another market already has, the save is refused and names the market holding it, so you can decide deliberately which market it should move from.
Inventory location
Every market names the inventory location its stock comes from. Once you have inventory locations, Inventory Location is required, and a new market starts on your default location. A shop without any locations sells from each product’s own quantity, so the field is hidden. The location drives what the market’s shoppers see as well as what they buy: in-stock and out-of-stock states and low-stock badges on the storefront are worked out from that location’s stock, and back-in-stock emails go out when that location is restocked. An order takes its stock from the market’s location unless a shipping method’s Fulfil from setting or an inventory rule chooses another.How a customer’s market is chosen
When a customer visits your store, Marzipan works through the following order and uses the first that applies:1
Explicit choice
A market chosen directly by the customer, through the currency switcher or a link.
2
Saved market
A signed-in customer’s previously saved market.
3
Automatic detection
A market matched automatically from the customer’s location.
4
Primary market
If none of the above apply, the customer sees your primary market.
Per-market pricing
On products, events, and subscription packages you can set optional price, sale price, and subscriber price overrides for each market. Where you don’t set an override, prices convert automatically from your base price using the market’s exchange rate.Per-market visibility
You can show or hide individual products, events, packages, and collections per market, so each region only sees what’s relevant to it. A basket only ever holds what its market sells. When a shopper switches market, or signs in and lands in a different market, any line the new market doesn’t sell is taken out of the basket and the storefront says which. A basket can’t check out with a product its market doesn’t sell. Word the notice under Settings > Branding & Web Components > Cart, in Item Removed on Market Change.Per-market stock
A product can be marked out of stock in some markets and not others. See Out of stock by market.Per-market images
A product keeps one gallery, and individual images can be scoped to the markets they belong in. An image with no markets set shows everywhere, so only the shots that differ need scoping. This is for the same SKU needing different imagery per market, usually because the physical label differs. A historical order keeps showing the image the customer actually bought, however the person looking at it is browsing.Stores with a single market don’t see the market tabs or the scope control at all.
Per-market product ordering
A collection can be ordered differently in each market. See Collections.Archiving and deleting markets
- Archive a market that has history (orders, subscriptions, or customers) to remove it from use while keeping its records intact
- Delete a market that’s unused and has no history

