• Updated

Markets help you target merchandising and create more personalized user experiences. For example, you can create a 20% off promotion for Independence Day in Canada. Only products in the Canadian market are eligible.

A single site can have multiple markets, each with its own product catalog, language, currency, and promotions. The market determines which products and prices a customer sees on the website. When creating a market, you can define a geographic entity (such as region, a country, or a group of countries).

Because developers implement markets during site creation, each implementation can be different. Some sites let the visitor select a market on the storefront. Others use URLs for different markets, such as and A site can also use a visitor's IP address to determine the appropriate market for their location.

Work with markets

  • You can filter results by market in the Catalog View.
  • You can assign a market, its price, and currency when defining a variant's pricing information.
  • You can filter Order Management objects like purchase orders, shopping carts, and subscriptions by market.
  • Customized Commerce automatically displays content in the market's language once you define it.

Browse markets

The Market overview displays existing markets with their languages, currencies, status, and whether the prices include tax.

Click a column header to sort the information on that property. You can also select which columns to display in the overview.


The Default Market defines the language and currency used for markets that are not specified.

Create or edit a market

  1. Go to Administration > Markets.
  2. Click a market in the list to edit the settings, or click Create.
  3. Fill in the following information, and click Save when done.
    • Market ID – Enter the identifier for the market.
    • Market Name – Enter the name that appears in the markets list.
    • Market Description – Explain the market (free-text).
    • Is Active – Select to activate. Only active markets are available to visitors.
    • Prices Include Tax – Select to indicate that returned prices include tax. This is typically used for markets where prices include tax, such as in the EU. You can use this setting to add checkout functionality displaying a tax-included price on the storefront.
    • Countries – Select countries to include in the market.
    • Languages – Select languages for the market. You must enable languages on the site to see this option.
    • Default Language – Select the default language.
    • Currencies – Select the currencies for the market.
    • Default Currency – Select the default currency.

Delete a market

  1. Select one or more markets from the list in the overview.
  2. Click Delete Selected, and click OK to confirm.