Choose a version:

Market

object

Requires read_markets for queries and both read_markets as well as write_markets for mutations.

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.

Anchor to Fields and connectionsFields and connections

Anchor to assignedCustomizationassignedCustomization • Boolean!non-null: Whether the market has a customization with the given ID.
Anchor to catalogscatalogs • MarketCatalogConnection!non-null: The catalogs that belong to the market.
Anchor to catalogsCountcatalogsCount • Count: The number of catalogs that belong to the market.
Anchor to conditionsconditions • MarketConditions: The conditions under which a visitor is in the market.
Anchor to currencySettingscurrencySettings • MarketCurrencySettings: The market’s currency settings.
Anchor to handlehandle • String!non-null: A short, human-readable unique identifier for the market. This is changeable by the merchant.
Anchor to idid • ID!non-null: A globally-unique ID.
Anchor to metafieldmetafield • 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.
Anchor to metafieldsmetafields • MetafieldConnection!non-null: A list of custom fields that a merchant associates with a Shopify resource.
Anchor to namename • String!non-null: The name of the market. Not shown to customers.
Anchor to priceInclusionspriceInclusions • MarketPriceInclusions: The inclusive pricing strategy for a market. This determines if prices include duties and / or taxes.
Anchor to statusstatus • MarketStatus!non-null: Status of the market. Replaces the enabled field.
Anchor to typetype • MarketType!non-null: The type of the market.
Anchor to webPresenceswebPresences • MarketWebPresenceConnection!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.

Deprecated fields and connections

Anchor to enabledenabled • Boolean!non-null: 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.
Anchor to metafieldDefinitionsmetafieldDefinitions • MetafieldDefinitionConnection!non-null: List of metafield definitions.
Anchor to priceListpriceList • PriceList: 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.
Anchor to primaryprimary • Boolean!non-null: Whether the market is the shop’s primary market.
Anchor to regionsregions • MarketRegionConnection!non-null: The regions that comprise the market.
Anchor to webPresencewebPresence • MarketWebPresence: 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.

Was this section helpful?

Anchor to QueriesQueries

Anchor to market market • query: Returns a market resource by ID.
Anchor to markets markets • query: The markets configured for the shop.

Deprecated queries

Anchor to marketByGeography marketByGeography • query: Returns the applicable market for a customer based on where they are in the world.
Anchor to primaryMarket primaryMarket • query: The primary market of the shop.

Was this section helpful?

Anchor to MutationsMutations

Anchor to marketCreate marketCreate • mutation: Creates a new market.
Anchor to marketCurrencySettingsUpdate marketCurrencySettingsUpdate • mutation: Updates currency settings of a market.
Anchor to marketUpdate marketUpdate • mutation: Updates the properties of a market.

Deprecated mutations

Anchor to marketRegionDelete marketRegionDelete • mutation: Deletes a market region.
Anchor to marketRegionsCreate marketRegionsCreate • mutation: Creates regions that belong to an existing market.
Anchor to marketWebPresenceCreate marketWebPresenceCreate • mutation: Creates a web presence for a market.
Anchor to marketWebPresenceDelete marketWebPresenceDelete • mutation: Deletes a market web presence.
Anchor to marketWebPresenceUpdate marketWebPresenceUpdate • mutation: Updates a market web presence.

Was this section helpful?

Anchor to InterfacesInterfaces

Anchor to HasMetafieldDefinitions HasMetafieldDefinitions • interface
Anchor to HasMetafields HasMetafields • interface
Anchor to Node Node • interface

Was this section helpful?