--- 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: 2024-10 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Market' md: 'https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Market.txt' --- # 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/2024-10/connections/MarketCatalogConnection) non-null The catalogs that belong to the market. * catalogs​Count [Count](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Count) The number of catalogs that belong to the market. * currency​Settings [Market​Currency​Settings!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MarketCurrencySettings) non-null The market’s currency settings. * handle [String!](https://shopify.dev/docs/api/admin-graphql/2024-10/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/2024-10/scalars/ID) non-null A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/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/2024-10/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/2024-10/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/2024-10/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/2024-10/scalars/Boolean) non-nullDeprecated * metafield​Definitions [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/MetafieldDefinitionConnection) non-nullDeprecated * price​List [Price​List](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/PriceList) Deprecated * primary [Boolean!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/Boolean) non-nullDeprecated * private​Metafield [Private​Metafield](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/PrivateMetafield) Deprecated * private​Metafields [Private​Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/PrivateMetafieldConnection) non-nullDeprecated * regions [Market​Region​Connection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/MarketRegionConnection) non-nullDeprecated * web​Presence [Market​Web​Presence](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MarketWebPresence) Deprecated *** ## Map ### Fields and connections with this object * {}[CompanyLocation.market](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CompanyLocation#field-market) * {}[Customer.market](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Customer#field-market) * {}[MarketCatalog.markets](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MarketCatalog#field-markets) * <->[MarketConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/MarketConnection#field-nodes) * {}[MarketEdge.node](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MarketEdge#field-node) * {}[MarketLocalization.market](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MarketLocalization#field-market) * {}[MarketWebPresence.market](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/MarketWebPresence#field-market) * {}[Translation.market](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/Translation#field-market) ### Possible type in * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/2024-10/unions/MetafieldReferencer) *** ## Queries * [market](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/market) query Returns a `Market` resource by ID. * [market​By​Geography](https://shopify.dev/docs/api/admin-graphql/2024-10/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/2024-10/queries/markets) query The markets configured for the shop. * [primary​Market](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/primaryMarket) query Deprecated *** ## \Market Queries ### Queried by * \[market](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/Market) * \[market​By​Geography](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/Market) * \[markets](https://shopify.dev/docs/api/admin-graphql/2024-10/queries/MarketConnection) *** ## Mutations * [market​Create](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketCreate) mutation Creates a new market. * [market​Update](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketUpdate) mutation Updates the properties of a market. ### Deprecated mutations * [market​Currency​Settings​Update](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketCurrencySettingsUpdate) mutation Deprecated * [market​Region​Delete](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketRegionDelete) mutation Deprecated * [market​Regions​Create](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketRegionsCreate) mutation Deprecated * [market​Web​Presence​Create](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketWebPresenceCreate) mutation Deprecated * [market​Web​Presence​Delete](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketWebPresenceDelete) mutation Deprecated * [market​Web​Presence​Update](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketWebPresenceUpdate) mutation Deprecated *** ## <\~> Market Mutations ### Mutated by * <\~>[market​Create](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketCreate) * <\~>[market​Update](https://shopify.dev/docs/api/admin-graphql/2024-10/mutations/marketUpdate) *** ## Interfaces * * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasMetafieldDefinitions) interface * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasMetafields) interface * [Node](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/Node) interface *** ## ||-Market Implements ### Implements * ||-[Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasMetafieldDefinitions) * ||-[Has​Metafields](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/HasMetafields) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/Node)