# Market - admin-graphql - OBJECT
Version: 2024-04

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

### Access Scopes
`read_markets` for queries and both `read_markets` as well as `write_markets` for mutations.


## Fields
* [catalogsCount](/docs/api/admin-graphql/2024-04/objects/Count): Count - The number of catalogs that belong to the market.
* [currencySettings](/docs/api/admin-graphql/2024-04/objects/MarketCurrencySettings): MarketCurrencySettings! - The market’s currency settings.
* [enabled](/docs/api/admin-graphql/2024-04/scalars/Boolean): Boolean! - 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.
* [handle](/docs/api/admin-graphql/2024-04/scalars/String): String! - A short, human-readable unique identifier for the market. This is changeable by the merchant.
* [id](/docs/api/admin-graphql/2024-04/scalars/ID): ID! - A globally-unique ID.
* [metafield](/docs/api/admin-graphql/2024-04/objects/Metafield): 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.
* [name](/docs/api/admin-graphql/2024-04/scalars/String): String! - The name of the market. Not shown to customers.
* [priceList](/docs/api/admin-graphql/2024-04/objects/PriceList): 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.
* [primary](/docs/api/admin-graphql/2024-04/scalars/Boolean): Boolean! - Whether the market is the shop’s primary market.
* [privateMetafield](/docs/api/admin-graphql/2024-04/objects/PrivateMetafield): PrivateMetafield - Returns a private metafield by namespace and key that belongs to the resource.
* [webPresence](/docs/api/admin-graphql/2024-04/objects/MarketWebPresence): 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](https://shopify.dev/themes/internationalization/multiple-currencies-languages#the-country-selector).
If it's the primary market and it has multiple web presences, then this field will return the primary domain web presence.

## Connections
* [catalogs](/docs/api/admin-graphql/2024-04/connections/MarketCatalogConnection): MarketCatalogConnection!
* [metafieldDefinitions](/docs/api/admin-graphql/2024-04/connections/MetafieldDefinitionConnection): MetafieldDefinitionConnection!
* [metafields](/docs/api/admin-graphql/2024-04/connections/MetafieldConnection): MetafieldConnection!
* [privateMetafields](/docs/api/admin-graphql/2024-04/connections/PrivateMetafieldConnection): PrivateMetafieldConnection!
* [regions](/docs/api/admin-graphql/2024-04/connections/MarketRegionConnection): MarketRegionConnection!
* [webPresences](/docs/api/admin-graphql/2024-04/connections/MarketWebPresenceConnection): MarketWebPresenceConnection!



## Related queries
* [market](/docs/api/admin-graphql/2024-04/queries/market) Returns a market resource by ID.
* [marketByGeography](/docs/api/admin-graphql/2024-04/queries/marketByGeography) Returns the applicable market for a customer based on where they are in the world.
* [primaryMarket](/docs/api/admin-graphql/2024-04/queries/primaryMarket) The primary market of the shop.
* [markets](/docs/api/admin-graphql/2024-04/queries/markets) The markets configured for the shop.

## Related mutations
* [marketCreate](/docs/api/admin-graphql/2024-04/mutations/marketCreate) Creates a new market.
* [marketCurrencySettingsUpdate](/docs/api/admin-graphql/2024-04/mutations/marketCurrencySettingsUpdate) Updates currency settings of a market.
* [marketRegionDelete](/docs/api/admin-graphql/2024-04/mutations/marketRegionDelete) Deletes a market region.
* [marketRegionsCreate](/docs/api/admin-graphql/2024-04/mutations/marketRegionsCreate) Creates regions that belong to an existing market.
* [marketUpdate](/docs/api/admin-graphql/2024-04/mutations/marketUpdate) Updates the properties of a market.
* [marketWebPresenceCreate](/docs/api/admin-graphql/2024-04/mutations/marketWebPresenceCreate) Creates a web presence for a market.
* [marketWebPresenceDelete](/docs/api/admin-graphql/2024-04/mutations/marketWebPresenceDelete) Deletes a market web presence.
* [marketWebPresenceUpdate](/docs/api/admin-graphql/2024-04/mutations/marketWebPresenceUpdate) Updates a market web presence.

## Related Unions
* [MetafieldReferencer](/docs/api/admin-graphql/2024-04/unions/MetafieldReferencer) Types of resources that may use metafields to reference other resources.

## Examples