--- title: Markets (UI) slug: commerce-connect-15/docs/markets-ui docTags: createdAt: 2026-07-30T20:34:41.000Z --- Markets in Optimizely Commerce Connect 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 you create a market, define a geographic entity (such as a 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 *yoursite.uk* and *yoursite.de*. A site can also use a visitor's IP address to determine the appropriate market for their location. Configuring markets correctly ensures customers see the right prices, languages, and payment options for their location. Common scenarios include the following: - **Geographic segmentation** – Create a separate market for each country or region you sell into (for example, *AUS*, *JPN*, *DEU*) so that currency, language, and tax settings are applied independently per region. - **Currency localization** – Assign a default currency and additional supported currencies to each market so prices display in the customer's local currency. - **Tax-inclusive pricing** – Enable the **Include Tax in Prices** option for markets where regulations require displayed prices to include tax (for example, most EU markets), ensuring compliance without changing your base price data. - **Lowest price transparency** – Enable the **Enable Lowest Price Display** option for markets where consumer protection regulations require showing the lowest price offered in a recent period. - **Language control** – Assign supported languages and a default language per market so storefront content, product descriptions, and UI labels are served in the correct language. Go to **Settings** > **Markets**. The **Markets** list page displays all configured markets and provides controls to create and manage them. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/QVoMMOOwQFciEFkIOQCea_38bf071ea0ddf8460d6015877066479a7bf29fd634a2e94b951d1db7982f9dfc-image.png) - **Create** – Opens the **Create Market** form to define a market. - **Checkbox column** – Selects one or more rows, typically for bulk actions. - **Market ID column** – Displays the unique programmatic identifier for each market as a clickable link (for example, *AUS*, *BRA*, *DEFAULT*). Clicking the ID opens the record for viewing or editing. - **Name column** – Displays the human-readable market name (for example, *Australia*, *Brazil*, *Default Market*). - **Default Lang... column** – Shows the default language code assigned to each market (for example, `en`). - **Default Curre... column** – Shows the default currency code assigned to each market (for example, `AUD`, `BRL`, `EUR`). - **Active column** – A checkmark indicates the market is active and available for use at checkout. The *Default Market* has no checkmark in this screenshot, indicating it is inactive. - **Price Include ... column** – A checkmark indicates that displayed prices in this market include tax. All visible markets have this disabled. - **Enable Lowes... column** – A checkmark indicates that the lowest recent selling price displays to customers in this market. All visible markets have this disabled. - **Sort toggle (**`∨`**)** – Changes the sort column or direction when clicked. - **Row action menu (⋮)** – A context menu on each row exposing record-level actions such as Edit and Delete. - **Page Size** – A drop-down list at the bottom left controlling how many rows display per page. Currently set to *10*. - **Pagination controls** – Lets you go between pages. This screenshot shows page *1* of *2*. The **Create Market** form defines a market and its regional settings across four sections: identity fields, country assignment, language assignment, and currency assignment. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/GmH8NfWfRpwaxxUmq-e8L_4ec1be77f1a23ff228801aec1253530d55beaf7e710839e84da06c9369dbc8f0-image.png) - **Market ID** – A required free-text field for the unique programmatic identifier of the market. Use a standard country or region code (for example, `AUS`, `DEU`, `DEFAULT`). This value cannot be changed after the market is saved. - **Market Name** – A required free-text field for the human-readable label of the market (for example, *Australia*, *Germany*). - **Market Description** – An optional multi-line text field for internal notes about the market, such as its scope, supported regions, or any special pricing rules that apply. - **Active** – When checked, the market is live and available at checkout. Leave unchecked to configure the market before making it available to customers. - **Enable Lowest Price Display** – When checked, the storefront displays the lowest selling price recorded in a configurable recent period. The inline note reads: *Display the lowest selling price in the past 0 days.* Set the number of days in your platform configuration to activate this feature. Use this for markets where price transparency regulations apply. - **Include Tax in Prices** – When checked, displayed prices in this market include tax. The inline note reads: *If checked, displayed prices in this market will include tax. This affects order calculations.* Enable this for markets where tax-inclusive pricing is legally required or expected by customers. **Countries** ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Zaz2q8vKe_BHxeNwZ03EK_ccfafc97a5197f738f1faf05db301d34b724d7a3a7325f4725d7a7d0cee4ea39-image.png) - **Available Countries** – The left panel lists all countries not yet assigned to this market. The list is scrollable and includes the full country catalog. - **Chosen Countries** – The right panel lists the countries included in this market. Only customers from these countries are matched to this market at checkout. - Transfer buttons (`»`, `>`, `<`, `«`) – Move countries between the **Available** and **Chosen** panels. `»` adds all, `>` adds selected, `<` removes selected, `«` removes all. **Languages** ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/lhq9SRSDh90xeUV7O5g-N_0695e124773c6fa07247753d74193ecc07612d8931c27eebc4c5770ce4e521dd-image.png) - **Available Languages** – The left panel lists all languages configured in your system that have not yet been assigned to this market (for example, *English*, *svenska*). - **Chosen Languages** – The right panel lists the languages available to customers in this market. **Default Language** A drop-down list for selecting which of the chosen languages serves as the fallback when no customer language preference is detected. Must be set to one of the languages in the **Chosen Languages** panel. **Currencies** ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Gr8oRCynzGoDmFlp3yXOc_522a81b2a90b36b7ffec6389c3978ff8b5aded8126c15ec490565654bf6c4feb-image.png) - **Available Currencies** – The left panel lists all currencies configured in your system that have not yet been assigned to this market (for example, *UAE Dirham*, *Afghanistan Afghani*, *Albanian Lek*). - **Chosen Currencies** – The right panel lists the currencies available for transactions in this market. **Default Currency** A drop-down list for selecting which of the chosen currencies is used by default for pricing and transactions in this market. Must be set to one of the currencies in the **Chosen Currencies** panel. ## Delete a market 1. Select one or more markets from the list in the overview. 2. Click **Delete Selected** and click **OK** to confirm.