Skip to main content
Log inSign up

Shopify uses cookies to provide necessary site functionality and improve your experience. By using our website, you agree to our privacy policy and our cookie policy.

queryDeprecated

Requires The user must have markets API access.

The primary market of the shop. Use backupRegion instead.

A market is a group of one or more regions that you want to target for international sales. By creating a market, you can configure a distinct, localized shopping experience for customers from a specific area of the world. For example, you can change currency, configure international pricing, or add market-specific domains or subfolders.

assignedCustomization
non-null

Whether the market has a customization with the given ID.

catalogs
non-null

The catalogs that belong to the market.

catalogsCount

The number of catalogs that belong to the market.

conditions

The conditions under which a visitor is in the market.

currencySettings

The market’s currency settings.

handle
non-null

A short, human-readable unique identifier for the market. This is changeable by the merchant.

id
non-null

A globally-unique ID.

metafield

A custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.

metafields
non-null

A list of custom fields that a merchant associates with a Shopify resource.

metafieldsByIdentifiers
non-null

The metafields associated with the resource matching the supplied list of namespaces and keys.

name
non-null

The name of the market. Not shown to customers.

priceInclusions

The inclusive pricing strategy for a market. This determines if prices include duties and / or taxes.

status
non-null

Status of the market. Replaces the enabled field.

type
non-null

The type of the market.

webPresences
non-null

The market’s web presences, which defines its SEO strategy. This can be a different domain, subdomain, or subfolders of the primary domain. Each web presence comprises one or more language variants. If a market doesn't have any web presences, then the market is accessible on the primary market's domains using country selectors.

enabled
non-nullDeprecated

Whether the market is enabled to receive visitors and sales. Note: Regions in inactive markets can't be selected on the storefront or in checkout. Use status instead.

metafieldDefinitions
non-nullDeprecated

List of metafield definitions. This field will be removed in a future version. Use the root metafieldDefinitions field instead.

priceList
Deprecated

The market’s price list, which specifies a percentage-based price adjustment as well as fixed price overrides for specific variants.

Markets with multiple catalogs can have multiple price lists. To query which price lists are connected to a market, please query for price lists through the catalogs connection. Use catalogs instead.

primary
non-nullDeprecated

Whether the market is the shop’s primary market. This field is deprecated and will be removed in the future.

regions
non-nullDeprecated

The regions that comprise the market. This field is deprecated and will be removed in the future. Use conditions.regionConditions instead.

webPresence
Deprecated

The market’s web presence, which defines its SEO strategy. This can be a different domain, subdomain, or subfolders of the primary domain. Each web presence comprises one or more language variants. If a market doesn't have its own web presence, then the market is accessible on the primary market's domains using country selectors. If it's the primary market and it has multiple web presences, then this field will return the primary domain web presence. Use webPresences instead.


Was this section helpful?