Skip to main content
A market is a region you sell to, grouped into a single pricing area with its own currency, languages and tax treatment. Rather than configuring each country separately, you group the countries that should behave the same way and set the rules once. Most stores start with one market covering everywhere they ship, and add more as they grow. A store selling into the EU and the US needs two, because one prices in euros with tax shown in the price and the other prices in dollars with tax added at checkout. Markets are also available as a rule condition on price lists, so a region can carry its own prices without duplicating products. To manage markets, navigate to Settings → Markets, under the Selling group.

​
Reviewing Your Markets

The Markets list, showing each market's currency, locale and tax treatment Each row shows:
  • Name - What the market is called. The countries it covers are listed beneath.
  • Currency - The currency all prices in this market are held in.
  • Default locale - The language shoppers in this market see first.
  • Tax - Whether prices in this market include tax or have it added at checkout.
  • Default - The market shown to shoppers whose country is unknown.
This list is dragged into order rather than sorted, so use the handle on any row to move it.

​
How to Create a Market

Click Add market. The Add market panel, with currency, locales and country coverage
  • Name - What the region is called internally, such as Europe or DACH.
  • Currency - The currency used for all prices in this market.
  • Default locale - The storefront language shoppers in this market see first.
  • Supported locales - Additional languages shoppers can switch to. The default locale is always included.
  • Countries - The countries this market covers. Search for each one and add it.
  • Tax engine - Which engine calculates tax for orders in this market. Leave this as it is unless another engine has been installed for your store.
  • Tax-inclusive pricing - Display prices with tax included. Common in EU markets.
  • Default market - Shoppers without a known country see this market. Only one can be default per store.
Click Create market when you are done.
Each country can belong to at most one market per store. A country already claimed by another market cannot be added to a second one, so plan your coverage before creating several markets.

​
What the built-in tax engine does not calculate

Spree’s built-in tax engine handles the rates you configure per country or state. Four things it does not do are printed under the Tax engine chooser, and each one can mean collecting the wrong amount of tax:
  • US local tax - “County, city and district rates are not applied, only the rates configured per country or state. Sales into US states that levy local tax will be under-collected.”
  • EU reverse charge - “A VAT-registered business buyer is charged tax instead of receiving a zero-rated invoice. Their registration number is recorded but does not change the tax.”
  • Distance-selling thresholds - “Crossing the EU-wide cross-border threshold does not switch to destination-country rates automatically, because it depends on annual turnover across every destination rather than on any single order.”
  • Proportional delivery tax - “Delivery is taxed at the single rate its delivery method names, not split across the rates of the goods being delivered. A basket mixing tax rates collects the wrong amount on delivery.”
If any of these apply to where you sell, connect a tax provider and then select it in Tax engine on every market it affects. Connecting a provider does not change anything on its own, and a market left on the built-in engine keeps calculating tax with it.
Tax rates and their calculators are configuration for the built-in engine, and do not decide which engine a market uses. Setting a rate’s calculator does not move that market off the built-in engine. See Tax Rates for what rates do.

​
How to Edit a Market

Click a market’s row to open it. The panel carries the same controls as the creation form, with chosen locales and countries shown as removable chips.

​
Changing a market’s currency

Changing the currency does not convert the prices you already have. It changes which currency the market’s prices are read from, and nothing is carried across:
  • Products need a base price in the new currency.
  • Price list entries for that market appear with empty prices until you fill them in.
Set the base prices and any price list prices in the new currency before switching a live market. A product with no price in the market’s currency is hidden from the storefront, unless Show products without a price is turned on in Store Details.

​
How to Delete a Market

Open the row menu and choose Delete.
Before deleting, check that no price list rules or storefront configuration reference this market. Countries covered by a deleted market are freed up and can be added to another one.

​
Further Reading