---
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](/docs/api/admin-graphql/2026-01/mutations/marketCurrencySettingsUpdate),

  [configure international
  pricing](https://shopify.dev/apps/internationalization/product-price-lists),

  or [add market-specific domains or
  subfolders](/docs/api/admin-graphql/2026-01/objects/MarketWebPresence).
api_version: 2026-01
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/docs/api/admin-graphql/2026-01/mutations/marketCurrencySettingsUpdate), [configure international pricing](https://shopify.dev/apps/internationalization/product-price-lists), or [add market-specific domains or subfolders](https://shopify.dev/docs/api/admin-graphql/2026-01/objects/MarketWebPresence).

## Fields

* assignedCustomization
* catalogs
* catalogsCount
* conditions
* currencySettings
* handle
* id
* metafield
* metafields
* name
* priceInclusions
* status
* type
* webPresences

### Deprecated fields

* enabled: deprecated
* metafieldDefinitions: deprecated
* priceList: deprecated
* primary: deprecated
* regions: deprecated
* webPresence: 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
* markets

### Deprecated queries

* marketByGeography: deprecated
* primaryMarket: 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/markets)

***

## Mutations

* marketCreate
* marketUpdate

### Deprecated mutations

* marketCurrencySettingsUpdate: deprecated
* marketRegionDelete: deprecated
* marketRegionsCreate: deprecated
* marketWebPresenceCreate: deprecated
* marketWebPresenceDelete: deprecated
* marketWebPresenceUpdate: 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

* HasMetafieldDefinitions
* HasMetafields
* Node

***

## 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)