---
title: About Shopify Markets preview
description: >-
  Learn about the new market capabilities available in the feature preview. You
  can create markets with conditions that match your buyers and offer
  customizations to enhance their experience.
source_url:
  html: 'https://shopify.dev/docs/apps/build/markets/new-markets/feature-preview'
  md: 'https://shopify.dev/docs/apps/build/markets/new-markets/feature-preview.md'
---

# About Shopify Markets preview

We're expanding Markets capabilities beyond region-based markets. New location-based (retail) and company location based (B2B) markets are now available, as well as enabling more customization options.

**Note:**

Not all merchant stores are eligible for the new markets experience. As an app developer, you must [check if the shop is onboarded on the new markets experience](https://shopify.dev/docs/apps/build/markets/new-markets/merchant-eligibility) before you can use the new [`marketCreate`](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/marketCreate) and [`marketUpdate`](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/marketUpdate) mutations.

***

## How it works

The following diagram describes the relationships between API objects related to markets:

![Market entities](https://shopify.dev/assets/assets/images/api/markets/market_entities-C13hg_WG.png)

| Api object | Description |
| - | - |
| Market | A group of one or more regions, company locations or retail locations to target sales. By creating a market, you can configure distinct, localized shopping experiences for customers. For example, you can configure currency, domains and languages, prices, published products, and theme customizations. |
| Condition | An attribute that qualifies a buyer for a market. For example, the region a buyer is located in, the company location they are purchasing on behalf of, or the retail location. |

### Market conditions

Market conditions define what types of buyers are going to match certain markets.

* A market with a `Region` condition of Canada will match all buyers from that region.

* A market with a `CompanyLocation` condition of a certain company will match all logged buyers from that company location.

* A market with a `Location` condition will match all POS buyers for that location.

  A market can also hold several conditions of the same type. For example, a market can hold several regions, like the US, Canada, or several company locations.

  Markets also support wildcards, which contain all retail locations or all company locations for a geography. For example, you might want to include all company locations in all regions, or all POS locations in Canada.

### Market customizations

A market can hold any combination of customizations.

* `CurrencySettings`: Associate a particular currency with a given market.
* `Catalogs`: Associate one or more catalogs with the market.
* `WebPresences`: Associate one or more web presences with the market.
* `PriceInclusions`: Associate different pricing behaviour for taxes and duties with a particular market

### Notable API changes

The new markets are supported on the 2025-04 and above API versions. These APIs include changes and deprecations that the developers must be aware of. The list below highlights the most important changes:

| Field | Description | without new markets | 2025-04 & unstable with new markets |
| - | - | - | - |
| `QueryRoot.markets` | Return the list of region markets on a store | Returns only region markets | Returns markets of all types (Region, B2B, Retail). |
| `Market.regions` | Returns the list of regions associated with a market | A region can only be in a single market. | A region can appear in multiple markets |
| The `Market.catalogs` | Returns the list of catalogs on a market | Markets always have 1 catalog | Market catalogs targeting regions, company locations and locations will be returned. 0 or many catalogs can be returned |
| `Market.currencySettings` | The currency setting of a market | Non-nullable field | Nullable field |
| `Market.webPresences` | The web presence of a market | Non-nullable field | Nullable field |
| `Market.webPresence` | The web presence of a market (deprecated in favour of Market.webPresences) | Nullable field | Nullable field |

***

## Next steps

* Learn how to [check merchant eligibility to the new markets](https://shopify.dev/docs/apps/build/markets/new-markets/merchant-eligibility)

***