Shopify helps merchants expand their business to a global audience, sell to multiple countries, and scale internationally. This means that many merchants need to sell in multiple languages and currencies.


This guide introduces the ways that you can configure localized experiences for merchants and customers using the [GraphQL Storefront API](/docs/api/storefront).

## How it works

You can use the Storefront API to complete the following tasks related to internationalization:

- Query [international prices](#international-pricing) for products and orders, and explicitly set the context of a cart and checkout.
- Support [multiple languages](#multiple-languages) on a storefront.

## International pricing

Users can configure the prices of products on a per country basis in their Shopify admin. For example, a storefront might have default prices for products set in USD, and price adjustments configured for Canada (CAD), Australia (AUD), and France (EUR).


To learn how to query international prices for products and orders, and explicitly set the context of a cart and checkout, refer to [Support international pricing on storefronts](/docs/storefronts/headless/building-with-the-storefront-api/markets/international-pricing).

The following diagram shows the different prices of the same product based on customer location:

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/apps/contextual-pricing-storefront-api-db78bfaac698c996e7e4b6f71ea937a605c44e5c819863ee7036b69fd717c7f8.png" class="lazyload" alt="A diagram showing different prices of the same product based on customer location" width="80%" height="1813"></figure>


## Multiple languages

You can use the Storefront API to [support multiple languages on a storefront](/docs/storefronts/headless/building-with-the-storefront-api/markets/multiple-languages). For example, you might want to retrieve the available languages for a Shopify store, retrieve translations, and create a checkout in the customer's language.

### Translatable resources

The following resources include translatable properties that can be retrieved by using the Storefront API:

<table>
  <tr>
    <th>Type</th>
    <th>Description</th>
    <th>Fields</th>
  </tr>
  <tr>
    <td><a href="/docs/api/storefront/latest/objects/collection"> Collection</a></td>
    <td>A grouping of products that a shop owner can create to organize them or make their shops easier to browse.</td>
    <td><code>title</code>, <code>descriptionHtml</code>, <code>description</code></td>
  </tr>
  <tr>
    <td><a href="/docs/api/storefront/latest/objects/metafield"> Metafield</a></td>
    <td>Custom metadata attached to a resource. Metafields can be sorted into namespaces and are comprised of keys, values, and value types.</td>
    <td><code>value</code></td>
  </tr>
  <tr>
    <td><a href="/docs/api/storefront/latest/objects/article"> Article</a></td>
    <td>An article in an online store blog.</td>
    <td><code>title</code>, <code>content</code>, <code>contentHtml</code>, <code>excerpt</code>, <code>excerptHtml</code></td>
  </tr>
  <tr>
    <td><a href="/docs/api/storefront/latest/objects/blog"> Blog</a></td>
    <td>An online store blog.</td>
    <td><code>title</code></td>
  </tr>
  <tr>
    <td><a href="/docs/api/storefront/latest/objects/page"> Page</a></td>
    <td>A custom page on the online store.</td>
    <td><code>title</code>, <code>body</code></td>
  </tr>
  <tr>
    <td><a href="/docs/api/storefront/latest/objects/product"> Product</a></td>
    <td>An individual item for sale in a Shopify store.</td>
    <td><code>title</code>, <code>descriptionHtml</code>, <code>description</code></td>
  </tr>
  <tr>
    <td><a href="/docs/api/storefront/latest/objects/productoption"> ProductOption</a></td>
    <td>Product property names like "Size", "Color", and "Material" that the customers can select. Variants are selected based on permutations of these options. 255 characters limit each.</td>
    <td><code>name</code>, <code>values</code></td>
  </tr>
  <tr>
    <td><a href="/docs/api/storefront/latest/objects/productvariant"> ProductVariant</a></td>
    <td>A different version of a product, such as differing sizes or differing colors.</td>
    <td><code>title</code>, <code>selectedOptions</code></td>
  </tr>
  <tr>
    <td><a href="/docs/api/storefront/latest/objects/shoppolicy"> ShopPolicy</a></td>
    <td>A policy that a merchant has configured for their store, such as their refund or privacy policy.</td>
    <td><code>body</code></td>
  </tr>
</table>

## Developer resources

Get familiar with the Storefront API by exploring guides that cover common use cases, and the complete reference for the GraphQL Storefront API.

<div class="resource-card-grid">
  <div>
  <a class="resource-card" href="/docs/storefronts/headless/building-with-the-storefront-api/markets/international-pricing" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/coin"
     data-alt-src="/assets/resource-cards/coin-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Support international pricing on storefronts
    </h3>
    <p class="resource-card__description">Learn how to support international pricing with the Storefront API.</p>
  </a>
</div>

<div>
  <a class="resource-card" href="/docs/storefronts/headless/building-with-the-storefront-api/markets/multiple-languages" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/globe"
     data-alt-src="/assets/resource-cards/globe-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      Support multiple languages on storefronts
    </h3>
    <p class="resource-card__description">Learn how to support multiple languages with the Storefront API.</p>
  </a>
</div>

<div>
  <a class="resource-card" href="/docs/api/storefront" data-theme-mode="">
    <div class="resource-card__indicator-container"><img
     src="/assets/resource-cards/storefront"
     data-alt-src="/assets/resource-cards/storefront-dark"
     aria-hidden="true"
     class="resource-card__icon themed-image"></div>
    <h3 class="resource-card__title">
      GraphQL Storefront API reference
    </h3>
    <p class="resource-card__description">Consult the complete reference for the GraphQL Storefront API.</p>
  </a>
</div>

</div>


## Next steps

- Learn how to query [international prices](/docs/storefronts/headless/building-with-the-storefront-api/markets/international-pricing) for products and orders, and explicitly set the context of a cart and checkout.
- Support [multiple languages](/docs/storefronts/headless/building-with-the-storefront-api/markets/multiple-languages) on a storefront with the Storefront API.