--- 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-01 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Market' md: 'https://shopify.dev/docs/api/admin-graphql/2025-01/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 * catalogs [Market​Catalog​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/MarketCatalogConnection) non-null The catalogs that belong to the market. * catalogs​Count [Count](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Count) The number of catalogs that belong to the market. * currency​Settings [Market​Currency​Settings!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/MarketCurrencySettings) non-null The market’s currency settings. * handle [String!](https://shopify.dev/docs/api/admin-graphql/2025-01/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/2025-01/scalars/ID) non-null A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/admin-graphql/2025-01/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/2025-01/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/2025-01/scalars/String) non-null The name of the market. Not shown to customers. * web​Presences [Market​Web​Presence​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-01/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/2025-01/scalars/Boolean) non-nullDeprecated * metafield​Definitions [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/MetafieldDefinitionConnection) non-nullDeprecated * price​List [Price​List](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/PriceList) Deprecated * primary [Boolean!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Boolean) non-nullDeprecated * regions [Market​Region​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/MarketRegionConnection) non-nullDeprecated * web​Presence [Market​Web​Presence](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/MarketWebPresence) Deprecated *** ## Map ### Fields and connections with this object * {}[CompanyLocation.market](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/CompanyLocation#field-CompanyLocation.fields.market) * {}[Customer.market](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Customer#field-Customer.fields.market) * {}[MarketCatalog.markets](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/MarketCatalog#field-MarketCatalog.fields.markets) * <->[MarketConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/MarketConnection#returns-nodes) * {}[MarketEdge.node](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/MarketEdge#field-MarketEdge.fields.node) * {}[MarketLocalization.market](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/MarketLocalization#field-MarketLocalization.fields.market) * {}[MarketWebPresence.market](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/MarketWebPresence#field-MarketWebPresence.fields.market) * {}[Translation.market](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Translation#field-Translation.fields.market) ### Possible type in * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/2025-01/unions/MetafieldReferencer) *** ## Queries * [market](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/market) query Returns a `Market` resource by ID. * [market​By​Geography](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/marketByGeography) query Returns the applicable market for a customer based on where they are in the world. * [markets](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/markets) query Returns a paginated list of [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) objects configured for the shop. Markets match buyers based on defined conditions to deliver customized shopping experiences. Filter markets by [`MarketType`](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketType) and [`MarketStatus`](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketStatus), search by name, and control sort order. Retrieve market configurations including [`MarketCurrencySettings`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCurrencySettings), [`MarketWebPresence`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence) objects, and [`MarketConditions`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketConditions). Learn more about [Shopify Markets](https://shopify.dev/docs/apps/build/markets). * [primary​Market](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/primaryMarket) query Deprecated *** ## \Market Queries ### Queried by * \[market](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/market) * \[market​By​Geography](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/marketByGeography) * \[markets](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/markets) *** ## Mutations * [market​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketCreate) mutation Creates a [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Market) to deliver customized shopping experiences. Markets define various aspects of the buyer experience including pricing, product availability, custom content, inventory and fulfillment priorities, and payment methods. Define conditions to match buyers by region, company location, retail location, or other criteria. Configure [`MarketCurrencySettings`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCurrencySettings) to control currency behavior. Set [`MarketPriceInclusions`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketPriceInclusions) to determine tax and duty display. Assign [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) objects and [`MarketWebPresence`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence) configurations to control product availability and SEO strategy. Learn more about [Shopify Markets](https://shopify.dev/docs/apps/build/markets). * [market​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketUpdate) mutation Updates the properties of a market. ### Deprecated mutations * [market​Currency​Settings​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketCurrencySettingsUpdate) mutation Deprecated * [market​Region​Delete](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketRegionDelete) mutation Deprecated * [market​Regions​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketRegionsCreate) mutation Deprecated * [market​Web​Presence​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketWebPresenceCreate) mutation Deprecated * [market​Web​Presence​Delete](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketWebPresenceDelete) mutation Deprecated * [market​Web​Presence​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketWebPresenceUpdate) mutation Deprecated *** ## <\~> Market Mutations ### Mutated by * <\~>[market​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketCreate) * <\~>[market​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketUpdate) *** ## Interfaces * * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/HasMetafieldDefinitions) interface * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/HasMetafields) interface * [Node](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/Node) interface *** ## ||-Market Implements ### Implements * ||-[Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/HasMetafieldDefinitions) * ||-[Has​Metafields](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/HasMetafields) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/Node)