<div class="doc-version" data-version="unstable"> <p>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 <a href="https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate">change currency</a>, <a href="https://shopify.dev/api/examples/product-price-lists">configure international pricing</a>, or <a href="https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence">add market-specific domains or subfolders</a>.</p> <div> <h2 id="on-this-page">On this page</h2> <ul> <li> <a href="#fields-unstable"> Fields </a> </li> <li> <a href="#types-that-return-market-unstable"> Types that return Market </a> </li> <li> <a href="#implements-unstable"> Implements </a> </li> </ul> </div> <h2 id="fields-unstable"> Fields </h2> <ul class="fields"> <li> <div class="field" id="handle-unstable"> <div class="field-name"> handle (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#handle-unstable"><code>Handle!</code></a>) </div> <div> <p>A human-readable unique string for the market automatically generated from its title.</p> </div> </div> </li> <li> <div class="field" id="id-unstable"> <div class="field-name"> id (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#id-unstable"><code>ID!</code></a>) </div> <div> <p>A globally-unique identifier.</p> </div> </div> </li> <li> <div class="field" id="metafield-unstable"> <div class="field-name"> metafield (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/metafield"><code>Metafield</code></a>) </div> <div> <p>Returns a metafield by namespace and key that belongs to the resource.</p> </div> </div> <div class="arguments-table"> <table> <tr> <th>Argument</th> <th>Description</th> </tr> <tr class="field-argument"> <td class="argument-name"> <code>key</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-unstable"> <code>String!</code> </a>) <span class="heading-flag">required</span> </td> <td class="argument-description"> <p>The key for the metafield.</p> </td> </tr> <tr class="field-argument"> <td class="argument-name"> <code>namespace</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-unstable"> <code>String</code> </a>) </td> <td class="argument-description"> <p>The container the metafield belongs to. If omitted, the app-reserved namespace will be used.</p> </td> </tr> </table> </div> </li> <li> <div class="field" id="regions-unstable"> <div class="field-name"> regions (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/marketregion"><code>[MarketRegion!]!</code></a>) </div> <div> <p>A geographic region which comprises a market.</p> </div> </div> </li> </ul> <h2 id="types-that-return-market-unstable"> Types that return Market </h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/localization#market-unstable"> <code>Localization.market</code> </a> </li> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/mailingaddress#market-unstable"> <code>MailingAddress.market</code> </a> </li> </ul> <h2 id="implements-unstable">Implements</h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/hasmetafields"> <code>HasMetafields</code> </a> </li> </ul> </div><div class="doc-version doc-version--rc" data-version="2025-04"> <p>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 <a href="https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate">change currency</a>, <a href="https://shopify.dev/api/examples/product-price-lists">configure international pricing</a>, or <a href="https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence">add market-specific domains or subfolders</a>.</p> <div> <h2 id="on-this-page">On this page</h2> <ul> <li> <a href="#fields-2025-04"> Fields </a> </li> <li> <a href="#types-that-return-market-2025-04"> Types that return Market </a> </li> <li> <a href="#implements-2025-04"> Implements </a> </li> </ul> </div> <h2 id="fields-2025-04"> Fields </h2> <ul class="fields"> <li> <div class="field" id="handle-2025-04"> <div class="field-name"> handle (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#handle-2025-04"><code>Handle!</code></a>) </div> <div> <p>A human-readable unique string for the market automatically generated from its title.</p> </div> </div> </li> <li> <div class="field" id="id-2025-04"> <div class="field-name"> id (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#id-2025-04"><code>ID!</code></a>) </div> <div> <p>A globally-unique identifier.</p> </div> </div> </li> <li> <div class="field" id="metafield-2025-04"> <div class="field-name"> metafield (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/metafield"><code>Metafield</code></a>) </div> <div> <p>Returns a metafield by namespace and key that belongs to the resource.</p> </div> </div> <div class="arguments-table"> <table> <tr> <th>Argument</th> <th>Description</th> </tr> <tr class="field-argument"> <td class="argument-name"> <code>key</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2025-04"> <code>String!</code> </a>) <span class="heading-flag">required</span> </td> <td class="argument-description"> <p>The key for the metafield.</p> </td> </tr> <tr class="field-argument"> <td class="argument-name"> <code>namespace</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2025-04"> <code>String</code> </a>) </td> <td class="argument-description"> <p>The container the metafield belongs to. If omitted, the app-reserved namespace will be used.</p> </td> </tr> </table> </div> </li> <li> <div class="field" id="regions-2025-04"> <div class="field-name"> regions (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/marketregion"><code>[MarketRegion!]!</code></a>) </div> <div> <p>A geographic region which comprises a market.</p> </div> </div> </li> </ul> <h2 id="types-that-return-market-2025-04"> Types that return Market </h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/localization#market-2025-04"> <code>Localization.market</code> </a> </li> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/mailingaddress#market-2025-04"> <code>MailingAddress.market</code> </a> </li> </ul> <h2 id="implements-2025-04">Implements</h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/hasmetafields"> <code>HasMetafields</code> </a> </li> </ul> </div><div class="doc-version doc-version--latest selected" data-version="2025-01"> <p>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 <a href="https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate">change currency</a>, <a href="https://shopify.dev/api/examples/product-price-lists">configure international pricing</a>, or <a href="https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence">add market-specific domains or subfolders</a>.</p> <div> <h2 id="on-this-page">On this page</h2> <ul> <li> <a href="#fields-2025-01"> Fields </a> </li> <li> <a href="#types-that-return-market-2025-01"> Types that return Market </a> </li> <li> <a href="#implements-2025-01"> Implements </a> </li> </ul> </div> <h2 id="fields-2025-01"> Fields </h2> <ul class="fields"> <li> <div class="field" id="handle-2025-01"> <div class="field-name"> handle (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#handle-2025-01"><code>Handle!</code></a>) </div> <div> <p>A human-readable unique string for the market automatically generated from its title.</p> </div> </div> </li> <li> <div class="field" id="id-2025-01"> <div class="field-name"> id (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#id-2025-01"><code>ID!</code></a>) </div> <div> <p>A globally-unique identifier.</p> </div> </div> </li> <li> <div class="field" id="metafield-2025-01"> <div class="field-name"> metafield (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/metafield"><code>Metafield</code></a>) </div> <div> <p>Returns a metafield by namespace and key that belongs to the resource.</p> </div> </div> <div class="arguments-table"> <table> <tr> <th>Argument</th> <th>Description</th> </tr> <tr class="field-argument"> <td class="argument-name"> <code>key</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2025-01"> <code>String!</code> </a>) <span class="heading-flag">required</span> </td> <td class="argument-description"> <p>The key for the metafield.</p> </td> </tr> <tr class="field-argument"> <td class="argument-name"> <code>namespace</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2025-01"> <code>String</code> </a>) </td> <td class="argument-description"> <p>The container the metafield belongs to. If omitted, the app-reserved namespace will be used.</p> </td> </tr> </table> </div> </li> <li> <div class="field" id="regions-2025-01"> <div class="field-name"> regions (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/marketregion"><code>[MarketRegion!]!</code></a>) </div> <div> <p>A geographic region which comprises a market.</p> </div> </div> </li> </ul> <h2 id="types-that-return-market-2025-01"> Types that return Market </h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/localization#market-2025-01"> <code>Localization.market</code> </a> </li> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/mailingaddress#market-2025-01"> <code>MailingAddress.market</code> </a> </li> </ul> <h2 id="implements-2025-01">Implements</h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/hasmetafields"> <code>HasMetafields</code> </a> </li> </ul> </div><div class="doc-version" data-version="2024-10"> <p>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 <a href="https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate">change currency</a>, <a href="https://shopify.dev/api/examples/product-price-lists">configure international pricing</a>, or <a href="https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence">add market-specific domains or subfolders</a>.</p> <div> <h2 id="on-this-page">On this page</h2> <ul> <li> <a href="#fields-2024-10"> Fields </a> </li> <li> <a href="#types-that-return-market-2024-10"> Types that return Market </a> </li> <li> <a href="#implements-2024-10"> Implements </a> </li> </ul> </div> <h2 id="fields-2024-10"> Fields </h2> <ul class="fields"> <li> <div class="field" id="handle-2024-10"> <div class="field-name"> handle (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#handle-2024-10"><code>Handle!</code></a>) </div> <div> <p>A human-readable unique string for the market automatically generated from its title.</p> </div> </div> </li> <li> <div class="field" id="id-2024-10"> <div class="field-name"> id (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#id-2024-10"><code>ID!</code></a>) </div> <div> <p>A globally-unique identifier.</p> </div> </div> </li> <li> <div class="field" id="metafield-2024-10"> <div class="field-name"> metafield (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/metafield"><code>Metafield</code></a>) </div> <div> <p>Returns a metafield by namespace and key that belongs to the resource.</p> </div> </div> <div class="arguments-table"> <table> <tr> <th>Argument</th> <th>Description</th> </tr> <tr class="field-argument"> <td class="argument-name"> <code>key</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2024-10"> <code>String!</code> </a>) <span class="heading-flag">required</span> </td> <td class="argument-description"> <p>The key for the metafield.</p> </td> </tr> <tr class="field-argument"> <td class="argument-name"> <code>namespace</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2024-10"> <code>String</code> </a>) </td> <td class="argument-description"> <p>The container the metafield belongs to. If omitted, the app-reserved namespace will be used.</p> </td> </tr> </table> </div> </li> <li> <div class="field" id="regions-2024-10"> <div class="field-name"> regions (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/marketregion"><code>[MarketRegion!]!</code></a>) </div> <div> <p>A geographic region which comprises a market.</p> </div> </div> </li> </ul> <h2 id="types-that-return-market-2024-10"> Types that return Market </h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/localization#market-2024-10"> <code>Localization.market</code> </a> </li> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/mailingaddress#market-2024-10"> <code>MailingAddress.market</code> </a> </li> </ul> <h2 id="implements-2024-10">Implements</h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/hasmetafields"> <code>HasMetafields</code> </a> </li> </ul> </div><div class="doc-version" data-version="2024-07"> <p>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 <a href="https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate">change currency</a>, <a href="https://shopify.dev/api/examples/product-price-lists">configure international pricing</a>, or <a href="https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence">add market-specific domains or subfolders</a>.</p> <div> <h2 id="on-this-page">On this page</h2> <ul> <li> <a href="#fields-2024-07"> Fields </a> </li> <li> <a href="#types-that-return-market-2024-07"> Types that return Market </a> </li> <li> <a href="#implements-2024-07"> Implements </a> </li> </ul> </div> <h2 id="fields-2024-07"> Fields </h2> <ul class="fields"> <li> <div class="field" id="handle-2024-07"> <div class="field-name"> handle (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#handle-2024-07"><code>Handle!</code></a>) </div> <div> <p>A human-readable unique string for the market automatically generated from its title.</p> </div> </div> </li> <li> <div class="field" id="id-2024-07"> <div class="field-name"> id (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#id-2024-07"><code>ID!</code></a>) </div> <div> <p>A globally-unique identifier.</p> </div> </div> </li> <li> <div class="field" id="metafield-2024-07"> <div class="field-name"> metafield (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/metafield"><code>Metafield</code></a>) </div> <div> <p>Returns a metafield by namespace and key that belongs to the resource.</p> </div> </div> <div class="arguments-table"> <table> <tr> <th>Argument</th> <th>Description</th> </tr> <tr class="field-argument"> <td class="argument-name"> <code>key</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2024-07"> <code>String!</code> </a>) <span class="heading-flag">required</span> </td> <td class="argument-description"> <p>The key for the metafield.</p> </td> </tr> <tr class="field-argument"> <td class="argument-name"> <code>namespace</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2024-07"> <code>String</code> </a>) </td> <td class="argument-description"> <p>The container the metafield belongs to. If omitted, the app-reserved namespace will be used.</p> </td> </tr> </table> </div> </li> <li> <div class="field" id="regions-2024-07"> <div class="field-name"> regions (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/marketregion"><code>[MarketRegion!]!</code></a>) </div> <div> <p>A geographic region which comprises a market.</p> </div> </div> </li> </ul> <h2 id="types-that-return-market-2024-07"> Types that return Market </h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/localization#market-2024-07"> <code>Localization.market</code> </a> </li> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/mailingaddress#market-2024-07"> <code>MailingAddress.market</code> </a> </li> </ul> <h2 id="implements-2024-07">Implements</h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/hasmetafields"> <code>HasMetafields</code> </a> </li> </ul> </div><div class="doc-version" data-version="2024-04"> <p>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 <a href="https://shopify.dev/api/admin-graphql/current/mutations/marketCurrencySettingsUpdate">change currency</a>, <a href="https://shopify.dev/api/examples/product-price-lists">configure international pricing</a>, or <a href="https://shopify.dev/api/admin-graphql/current/objects/MarketWebPresence">add market-specific domains or subfolders</a>.</p> <div> <h2 id="on-this-page">On this page</h2> <ul> <li> <a href="#fields-2024-04"> Fields </a> </li> <li> <a href="#types-that-return-market-2024-04"> Types that return Market </a> </li> <li> <a href="#implements-2024-04"> Implements </a> </li> </ul> </div> <h2 id="fields-2024-04"> Fields </h2> <ul class="fields"> <li> <div class="field" id="handle-2024-04"> <div class="field-name"> handle (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#handle-2024-04"><code>Handle!</code></a>) </div> <div> <p>A human-readable unique string for the market automatically generated from its title.</p> </div> </div> </li> <li> <div class="field" id="id-2024-04"> <div class="field-name"> id (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#id-2024-04"><code>ID!</code></a>) </div> <div> <p>A globally-unique identifier.</p> </div> </div> </li> <li> <div class="field" id="metafield-2024-04"> <div class="field-name"> metafield (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/metafield"><code>Metafield</code></a>) </div> <div> <p>Returns a metafield by namespace and key that belongs to the resource.</p> </div> </div> <div class="arguments-table"> <table> <tr> <th>Argument</th> <th>Description</th> </tr> <tr class="field-argument"> <td class="argument-name"> <code>key</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2024-04"> <code>String!</code> </a>) <span class="heading-flag">required</span> </td> <td class="argument-description"> <p>The key for the metafield.</p> </td> </tr> <tr class="field-argument"> <td class="argument-name"> <code>namespace</code> (<a href="/api/functions/reference/cart-checkout-validation/graphql/scalar#string-2024-04"> <code>String</code> </a>) </td> <td class="argument-description"> <p>The container the metafield belongs to. If omitted, the app-reserved namespace will be used.</p> </td> </tr> </table> </div> </li> <li> <div class="field" id="regions-2024-04"> <div class="field-name"> regions (<a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/marketregion"><code>[MarketRegion!]!</code></a>) </div> <div> <p>A geographic region which comprises a market.</p> </div> </div> </li> </ul> <h2 id="types-that-return-market-2024-04"> Types that return Market </h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/localization#market-2024-04"> <code>Localization.market</code> </a> </li> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/mailingaddress#market-2024-04"> <code>MailingAddress.market</code> </a> </li> </ul> <h2 id="implements-2024-04">Implements</h2> <ul> <li> <a href="/api/functions/reference/cart-checkout-validation/graphql/common-objects/hasmetafields"> <code>HasMetafields</code> </a> </li> </ul> </div>