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