Skip to main content
Anchor to Market

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, configure international pricing, or add market-specific domains or subfolders.

Anchor to FieldsFields

Anchor to assignedCustomizationassignedCustomization
•Boolean!
non-null

Whether the market has a customization with the given ID.

Arguments

Anchor to customizationIdcustomizationId
•ID!
required

The ID of the customization that the market has been assigned to.

Anchor to catalogscatalogs
•MarketCatalogConnection!
non-null

The catalogs that belong to the market.

Anchor to catalogsCountcatalogsCount
•Count

The number of catalogs that belong to the market.

Anchor to conditionsconditions
•MarketConditions

The conditions under which a visitor is in the market.

Anchor to currencySettingscurrencySettings
•MarketCurrencySettings

The market’s currency settings.

Anchor to handlehandle
•String!
non-null

A short, human-readable unique identifier for the market. This is changeable by the merchant.

Anchor to idid
•ID!
non-null

A globally-unique ID.

Anchor to metafieldmetafield
•Metafield

A custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.

Anchor to metafieldsmetafields
•MetafieldConnection!
non-null

A list of custom fields that a merchant associates with a Shopify resource.

Anchor to namename
•String!
non-null

The name of the market. Not shown to customers.

Anchor to priceInclusionspriceInclusions
•MarketPriceInclusions

The inclusive pricing strategy for a market. This determines if prices include duties and / or taxes.

Anchor to statusstatus
•MarketStatus!
non-null

Status of the market. Replaces the enabled field.

Anchor to typetype
•MarketType!
non-null

The type of the market.

Anchor to webPresenceswebPresences
•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.

Deprecated fields

Anchor to enabledenabled
•Boolean!
non-nullDeprecated
Anchor to metafieldDefinitionsmetafieldDefinitions
•MetafieldDefinitionConnection!
non-nullDeprecated
Anchor to priceListpriceList
•PriceList
Deprecated
Anchor to primaryprimary
•Boolean!
non-nullDeprecated
Anchor to regionsregions
•MarketRegionConnection!
non-nullDeprecated
Anchor to webPresencewebPresence
•MarketWebPresence
Deprecated
Was this section helpful?

Anchor to QueriesQueries

Anchor to marketmarket
•query

Returns a Market resource by ID.

Anchor to marketsmarkets
•query

Returns a paginated list of Market objects configured for the shop. Markets match buyers based on defined conditions to deliver customized shopping experiences.

Filter markets by MarketType and MarketStatus, search by name, and control sort order. Retrieve market configurations including MarketCurrencySettings, MarketWebPresence objects, and MarketConditions.

Learn more about Shopify Markets.

Deprecated queries

Anchor to marketByGeographymarketByGeography
•query
Deprecated
Anchor to primaryMarketprimaryMarket
•query
Deprecated
Was this section helpful?

Anchor to MutationsMutations

Anchor to marketCreatemarketCreate
•mutation

Creates a 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 to control currency behavior. Set MarketPriceInclusions to determine tax and duty display. Assign Catalog objects and MarketWebPresence configurations to control product availability and SEO strategy.

Learn more about Shopify Markets.

Anchor to marketUpdatemarketUpdate
•mutation

Updates the properties of a market.

Deprecated mutations

Anchor to marketCurrencySettingsUpdatemarketCurrencySettingsUpdate
•mutation
Deprecated
Anchor to marketRegionDeletemarketRegionDelete
•mutation
Deprecated
Anchor to marketRegionsCreatemarketRegionsCreate
•mutation
Deprecated
Anchor to marketWebPresenceCreatemarketWebPresenceCreate
•mutation
Deprecated
Anchor to marketWebPresenceDeletemarketWebPresenceDelete
•mutation
Deprecated
Anchor to marketWebPresenceUpdatemarketWebPresenceUpdate
•mutation
Deprecated
Was this section helpful?

Anchor to InterfacesInterfaces

Was this section helpful?