Markets
Markets let one store sell to several countries, each in its own currency. A market is a group of countries with its own currency, price rounding, price adjustment, and tax display. Shoppers see prices, cart, delivery, and checkout in their market’s currency.
Open Commerce → Settings → Markets. You need the commerce.manage permission to change them. If you run several stores, each store has its own markets. Pick the store at the top of the tab.
The primary market
Section titled “The primary market”Every store has a Primary market. It sells in your store’s own currency, and shoppers from countries no other market lists shop there too.
Click Edit on the primary market to set its countries, tax display, and languages. Once you add other markets, the primary market needs at least one country, usually your store’s own country. Shoppers use it to switch back from the country selector.
Add a market
Section titled “Add a market”- Click Add market.
- Enter a Name, such as “Gulf”.
- Pick Countries. A country can only be in one market. Countries already used show which market they’re in.
- Pick a Currency. Only currencies with an exchange rate work. Add currencies and exchange rates in Settings → Currencies.
- Choose the Price rounding: Don’t round, Round up to .99, Round up to .95, Round up to a whole number, Round up to the next 5, or Round up to the next 10.
- Optionally set a Price adjustment (%) between −90 and 500 to raise or lower every price in this market, for example 10 to cover import costs.
- Choose how Prices show: Before tax (tax added at checkout) or Tax included.
- Pick the Languages the store’s language selector offers in this market. Leave it empty for all the store’s languages.
- Keep Sell in this market on, and click Save.
The form shows an example price as you go, such as “A 10.00 USD product shows as 37.99 SAR.”
A store can have up to 30 markets. Saving is logged in the audit trail, and your live store uses the change within a minute.
Click Remove market to delete one. Shoppers there go back to the primary market.
How prices are worked out
Section titled “How prices are worked out”For each product in a market:
- The price is converted from the store currency at your exchange rate.
- The price adjustment is applied.
- The result is rounded up to the chosen ending.
Currencies with three decimals, such as JOD and KWD, round to steps of 10 fils, which is what cards can charge. When a market shows prices with tax included, the price is rounded with tax and the net price is worked back from it.
Discounts with fixed amounts and shipping rates in the store currency are converted the same way. If a shipping zone has a rate in the market’s currency, that rate is used as it is.
What shoppers see
Section titled “What shoppers see”Which market a shopper is in
Section titled “Which market a shopper is in”The Shopper’s market setting, Pick the market from where the shopper is, chooses a market from the shopper’s country, then from their browser language. If it’s off, everyone starts in the primary market.
Shoppers can always change market with the Country/region selector in your store’s header. The selector shows when the store sells to more than one market. Turn it on or off in the builder under Theme settings → Header. The header’s Language selector is off by default.
Prices, cart, and checkout
Section titled “Prices, cart, and checkout”- Product pages, collections, search, and the cart show prices in the market’s currency.
- In a Tax included market, shelf prices and the cart show tax, with “Tax included.” under the subtotal.
- At checkout, the delivery country decides the market. If the shopper’s address is in another market, the cart moves to that market and checkout reloads with the new prices.
- The order is placed in the market’s currency and keeps the exchange rate of that moment. Card payments are charged in that currency.
Orders keep their net amounts and tax the same way in every market, so invoices and accounting stay correct.
If your store currency itself has no exchange rate to your base currency, the Markets tab shows a warning and checkout can’t take orders until you add the rate.
Preview a market in the builder
Section titled “Preview a market in the builder”In the store builder, use Preview in market in the top bar to see the store’s prices and country selector as a shopper in that market sees them.
What markets don’t change yet
Section titled “What markets don’t change yet”- Store languages are English and Arabic.
- Products are available in every market. Per-market availability, per-market domains, and market-specific theme content aren’t available yet.
- Gift cards work only in their own currency.
- llms.txt and the store’s MCP server always answer in the store’s own currency.