--- title: Market - GraphQL Admin description: |- 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](https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate), [configure international pricing](https://shopify.dev/apps/internationalization/product-price-lists), or [add market-specific domains or subfolders](https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence). api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/objects/Market md: https://shopify.dev/docs/api/admin-graphql/latest/objects/Market.md --- # 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](https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate), [configure international pricing](https://shopify.dev/apps/internationalization/product-price-lists), or [add market-specific domains or subfolders](https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence). ## Fields * assigned​Customization [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the market has a customization with the given ID. * customization​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required ### Arguments The ID of the customization that the market has been assigned to. *** * catalogs [Market​Catalog​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MarketCatalogConnection) non-null The catalogs that belong to the market. * catalogs​Count [Count](https://shopify.dev/docs/api/admin-graphql/latest/objects/Count) The number of catalogs that belong to the market. * conditions [Market​Conditions](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketConditions) The conditions under which a visitor is in the market. * currency​Settings [Market​Currency​Settings](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCurrencySettings) The market’s currency settings. * handle [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null A short, human-readable unique identifier for the market. This is changeable by the merchant. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield) A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. * metafields [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MetafieldConnection) non-null A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. * name [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The name of the market. Not shown to customers. * price​Inclusions [Market​Price​Inclusions](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketPriceInclusions) The inclusive pricing strategy for a market. This determines if prices include duties and / or taxes. * status [Market​Status!](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketStatus) non-null Status of the market. Replaces the enabled field. * type [Market​Type!](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketType) non-null The type of the market. * web​Presences [Market​Web​Presence​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/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](https://shopify.dev/themes/internationalization/multiple-currencies-languages#the-country-selector). ### Deprecated fields * enabled [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-nullDeprecated * metafield​Definitions [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MetafieldDefinitionConnection) non-nullDeprecated * price​List [Price​List](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceList) Deprecated * primary [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-nullDeprecated * regions [Market​Region​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MarketRegionConnection) non-nullDeprecated * web​Presence [Market​Web​Presence](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence) Deprecated *** ## Map ### Fields and connections with this object * {}[MarketCatalog.markets](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCatalog#field-MarketCatalog.fields.markets) * <->[MarketConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/MarketConnection#returns-nodes) * {}[MarketEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketEdge#field-MarketEdge.fields.node) * {}[MarketLocalization.market](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketLocalization#field-MarketLocalization.fields.market) * {}[MarketWebPresence.markets](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence#field-MarketWebPresence.fields.markets) * {}[Translation.market](https://shopify.dev/docs/api/admin-graphql/latest/objects/Translation#field-Translation.fields.market) ### Possible type in * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer) *** ## Queries * [market](https://shopify.dev/docs/api/admin-graphql/latest/queries/market) query Returns a `Market` resource by ID. * [markets](https://shopify.dev/docs/api/admin-graphql/latest/queries/markets) query The markets configured for the shop. ### Deprecated queries * [market​By​Geography](https://shopify.dev/docs/api/admin-graphql/latest/queries/marketByGeography) query Deprecated * [primary​Market](https://shopify.dev/docs/api/admin-graphql/latest/queries/primaryMarket) query Deprecated *** ## \Market Queries ### Queried by * \[market](https://shopify.dev/docs/api/admin-graphql/latest/queries/Market) * \[markets](https://shopify.dev/docs/api/admin-graphql/latest/queries/MarketConnection) *** ## Mutations * [market​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketCreate) mutation Creates a new market. * [market​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketUpdate) mutation Updates the properties of a market. ### Deprecated mutations * [market​Currency​Settings​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketCurrencySettingsUpdate) mutation Deprecated * [market​Region​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketRegionDelete) mutation Deprecated * [market​Regions​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketRegionsCreate) mutation Deprecated * [market​Web​Presence​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketWebPresenceCreate) mutation Deprecated * [market​Web​Presence​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketWebPresenceDelete) mutation Deprecated * [market​Web​Presence​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketWebPresenceUpdate) mutation Deprecated *** ## <\~> Market Mutations ### Mutated by * <\~>[market​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketCreate) * <\~>[market​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketUpdate) *** ## Interfaces * * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions) interface * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) interface * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-Market Implements ### Implements * ||-[Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions) * ||-[Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)