---
title: ShopLocale - GraphQL Admin
description: A locale that's been enabled on a shop.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopLocale
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopLocale.md
---

# Shop​Locale

object

Requires `read_locales` access scope or `read_markets_home` access scope.

A locale that's been enabled on a shop.

## Fields

* locale

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

  non-null

  The locale ISO code.

* market​Web​Presences

  [\[Market​Web​Presence!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence)

  non-null

  The market web presences that use the locale.

* name

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

  non-null

  The human-readable locale name.

* primary

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Whether the locale is the default locale for the shop.

* published

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Whether the locale is visible to buyers.

***

## Map

### Fields with this object

* {}[MarketWebPresence.alternateLocales](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence#field-MarketWebPresence.fields.alternateLocales)
* {}[MarketWebPresence.defaultLocale](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence#field-MarketWebPresence.fields.defaultLocale)

***

## Queries

* [shop​Locales](https://shopify.dev/docs/api/admin-graphql/latest/queries/shopLocales)

  query

  A list of locales available on a shop.

***

## \<?>ShopLocale Queries

### Queried by

* \<?>[shop​Locales](https://shopify.dev/docs/api/admin-graphql/latest/queries/ShopLocale)

***

## Mutations

* [shop​Locale​Enable](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shopLocaleEnable)

  mutation

  Adds a locale for a shop. The newly added locale is in the unpublished state.

* [shop​Locale​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shopLocaleUpdate)

  mutation

  Updates a locale for a shop.

***

## <\~> ShopLocale Mutations

### Mutated by

* <\~>[shop​Locale​Enable](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shopLocaleEnable)
* <\~>[shop​Locale​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shopLocaleUpdate)