Skip to main content
Markets let you sell in more than one currency and tailor pricing to different regions. Each market defines a currency and the prices customers in that region see. Navigate to Settings > Markets to manage your markets. Your primary market is created automatically from your store’s default currency. It’s the market customers fall back to when no other applies, so you always have at least one.
Markets list

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 Europe or United 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.
Under Currency:
  • 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.0 for 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)
Under Countries, choose the countries that use this market. Customers in these countries see it automatically.
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.
Set per-market free-shipping messages under Settings > Branding & Web Components > Cart.

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