---
title: Country - Storefront API
description: >-
  A country with localization settings for a storefront. Includes the country's

  currency, available languages, default language, and unit system (metric or
  imperial).


  Access countries through the
  [localization](/docs/api/storefront/2026-07/queries/localization)

  query, which returns both the list of available countries and the currently

  active country. Use the
  [`@inContext`](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/in-context)

  directive to change the active country context.
api_version: 2026-07
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/Country'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/Country.md'
api_name: storefront
api_type: graphql
type: object
---

# Country

object

A country with localization settings for a storefront. Includes the country's currency, available languages, default language, and unit system (metric or imperial).

Access countries through the [localization](https://shopify.dev/docs/api/storefront/2026-07/queries/localization) query, which returns both the list of available countries and the currently active country. Use the [`@inContext`](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/in-context) directive to change the active country context.

## Fields

* available​Languages

  [\[Language!\]!](https://shopify.dev/docs/api/storefront/latest/objects/Language)

  non-null

  The languages available for the country.

* currency

  [Currency!](https://shopify.dev/docs/api/storefront/latest/objects/Currency)

  non-null

  The currency of the country.

* default​Language

  [Language!](https://shopify.dev/docs/api/storefront/latest/objects/Language)

  non-null

  The default language for the country.

* iso​Code

  [Country​Code!](https://shopify.dev/docs/api/storefront/latest/enums/CountryCode)

  non-null

  The ISO code of the country.

* name

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null

  The name of the country.

* unit​System

  [Unit​System!](https://shopify.dev/docs/api/storefront/latest/enums/UnitSystem)

  non-null

  The unit system used in the country.

* market

  [Market](https://shopify.dev/docs/api/storefront/latest/objects/Market)

  Deprecated

***

## Map

### Fields with this object

* [Localization.availableCountries](https://shopify.dev/docs/api/storefront/latest/objects/Localization#field-Localization.fields.availableCountries)
* [Localization.country](https://shopify.dev/docs/api/storefront/latest/objects/Localization#field-Localization.fields.country)
