> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/connected-apps/shopify/shopify-markets.md).

# Shopify Markets

### Overview

Shopify Markets allows merchants to configure different selling experiences for specific countries, regions, customer groups, retail locations, or sales channels from a single Shopify store.

A Market can define:

* The countries or regions included in the Market
* The currency used by customers
* The catalogs and pricing available to customers
* Discounts
* Domain and language
* Taxes and duties
* Shipping options and rates

For example, a merchant can create an **Africa** Market and include multiple countries within it. The merchant can then configure the currency, catalogs, taxes, shipping, and other settings that apply to customers in those countries.

Shopify also supports inherited settings, meaning a new Market can initially use settings from the store default or its parent Market and only customize the settings that need to be different.

Before creating a Market, it is important to understand the relationship between **Market, Catalog, Currency, and Customer Order**.

1. **Market:** A Market identifies a specific selling audience or geographic region.

For example:

* Canada
* United States
* United Kingdom
* Africa

A Market can contain one or multiple countries or regions.

2. **Catalog:** A Catalog controls which products are available in a Market and can define the prices for those products.

For example: **Africa Market → Fittler Market Catalog**

| Item   | Catalog Price |
| ------ | ------------- |
| Item A | $50           |
| Item B | $75           |
| Item C | $100          |

Shopify applies the applicable catalog pricing when a customer in that Market purchases the item. Catalogs can also control product availability.

3. **Currency:** A Market can use a specific currency or local currencies.

For example: **Canada Market → CAD, United States Market → USD**

For a multi-country Market, Shopify can also use local currencies so customers in different countries see prices in their local currency.

### Creating a Market

1. To create a Market, navigate to **Menu → Markets**. The Markets page displays the existing Markets and their current status.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FoUqJ4me7ZDgxOkOFIFdW%2Fimage.png?alt=media&amp;token=a4685473-503d-481c-8f02-dadbf84485a6" alt=""><figcaption></figcaption></figure>

2. Click **Create market** and enter a name for the Market. The Market name is used to identify the Market in the Shopify Admin.
3. Select the Market status:
   * **Draft** — Creates the Market without making it available to customers.
   * **Active** — Makes the Market available to customers once the required configuration is complete.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2Fn7UN0tDrf2kz2T5NWX9g%2Fimage.png?alt=media&amp;token=9a77b81b-4d94-412c-ae3f-2486ead6a776" alt=""><figcaption></figcaption></figure>

Shopify recommends configuring the Market and ensuring shipping rates are available before activating it.

#### Adding Countries or Regions to the Market

After entering the Market name, configure the countries or regions that belong to the Market.

1. In the **Includes** section, click **Add condition**.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2F5OXBzKiM2GgmWBJeB5lK%2Fimage.png?alt=media&amp;token=2aa29958-0ed8-4d59-8561-3c64669d6af4" alt=""><figcaption></figcaption></figure>

2. Select **Regions**. Search for and select the required countries or regions. Click **Done**.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FJ064HHijWgjvCuc2IQlh%2Fimage.png?alt=media&amp;token=23cc4288-8411-4490-ab4d-d3d9850fa095" alt=""><figcaption></figcaption></figure>

3. The selected countries are now associated with the Market. A country should belong to the appropriate Market before configuring shipping for that country.&#x20;

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FZYnUMuX5VJK8Jkjv6PPo%2Fimage.png?alt=media&amp;token=90030c97-02ee-45b6-a8c9-4bc9a8cf2a8d" alt=""><figcaption></figcaption></figure>

Once the countries are selected, Shopify displays the settings for the Market. Some settings may initially appear under **Inherited**. This means the Market is using the configuration from the store default.

When you customize a setting, it moves from **Inherited** to **Customized**. This allows you to change only the settings that need to be different for the Market.

#### Configuring Currency

Currency determines the currency displayed to customers in the Market. Depending on the Market, you can configure a specific currency or use local currencies.

For example: The **Use local currencies** option allows customers to pay in the currency associated with their region.

#### Configuring Catalogs

This is particularly important when different Markets need different product pricing.

1. Under **Customized**, locate **Catalogs**. Click the **+** icon.
2. &#x20;Select the Catalogs that should apply to the Market. You can also create a new catalog.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FYKLNdKwtov8hCSNUwEHb%2Fimage.png?alt=media&amp;token=839bdf05-ead6-4560-84a5-835c6398fc00" alt=""><figcaption></figcaption></figure>

A Catalog determines which products are available to customers in the Market and what prices apply to those products.

#### Configuring Discounts

The **Discounts** setting allows you to configure which eligible discounts apply to the Market.

1. Locate **Discounts**. Click the **+** icon.
2. Select or configure the required discount settings. Click **Done**.

Discount behavior can vary depending on the type of discount and Market configuration.

#### Configuring Domain and Language

The **Domain/language** setting determines the domain and language experience associated with the Market. A Market can therefore provide a localized storefront experience for its customers.

#### Configuring Taxes and Duties

The **Taxes and duties** setting controls tax and duty behavior for the Market. Depending on the store configuration, options can include:

* Sales tax
* Duties and import tax
* Tax display
* Duty display

Shopify's Markets settings allow tax-inclusive pricing and duty collection to be customized by Market.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FVpXf1uu9xk3Xbfd1x6h1%2Fimage.png?alt=media&amp;token=7f4abbb2-2e6b-48c8-8456-53788729d788" alt=""><figcaption></figcaption></figure>

***

### Setting Up Shipping for the Market

Creating a Market alone does **not** mean customers can place orders. The Market must have appropriate shipping configuration.

#### Setting Up Shipping Rates

1. Click on **Manage Shipping**. The user is navigated to the **Shipping and delivery** section.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FCBy6NToUTMor1MHmLVA0%2Fimage.png?alt=media&amp;token=aacb4cf0-b37b-4c6f-86cf-0224170c2688" alt=""><figcaption></figcaption></figure>

2. Configure the shipping options for the selected **Market** by clicking **Add a shipping option** and selecting the required **Rate Type**.

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FcsGfGykPho8O8GbtTQTD%2Fimage.png?alt=media&amp;token=1a6e5669-5a96-4063-b326-27229a6a9584" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.xorosoft.com/xoroerp-1/connected-apps/shopify/shopify-markets.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.