--- title: shop - Storefront API description: >- Returns the [`Shop`](/docs/api/storefront/2026-10/objects/Shop) associated with the storefront access token. The `Shop` object provides general store information such as the shop name, description, and primary domain. Use this query to access data like store policies, [`PaymentSettings`](/docs/api/storefront/2026-10/objects/PaymentSettings), [`Brand`](/docs/api/storefront/2026-10/objects/Brand) configuration, and shipping destinations. It also exposes [`ShopPayInstallmentsPricing`](/docs/api/storefront/2026-10/objects/ShopPayInstallmentsPricing) and [`SocialLoginProvider`](/docs/api/storefront/2026-10/objects/SocialLoginProvider) options for customer accounts. api_version: 2026-10 source_url: html: 'https://shopify.dev/docs/api/storefront/latest/queries/shop' md: 'https://shopify.dev/docs/api/storefront/latest/queries/shop.md' api_name: storefront api_type: graphql type: query --- # shop query Returns the [`Shop`](https://shopify.dev/docs/api/storefront/2026-10/objects/Shop) associated with the storefront access token. The `Shop` object provides general store information such as the shop name, description, and primary domain. Use this query to access data like store policies, [`PaymentSettings`](https://shopify.dev/docs/api/storefront/2026-10/objects/PaymentSettings), [`Brand`](https://shopify.dev/docs/api/storefront/2026-10/objects/Brand) configuration, and shipping destinations. It also exposes [`ShopPayInstallmentsPricing`](https://shopify.dev/docs/api/storefront/2026-10/objects/ShopPayInstallmentsPricing) and [`SocialLoginProvider`](https://shopify.dev/docs/api/storefront/2026-10/objects/SocialLoginProvider) options for customer accounts. ## Possible returns * Shop [Shop!](https://shopify.dev/docs/api/storefront/latest/objects/Shop) The central hub for store-wide settings and information accessible through the Storefront API. Provides the shop's name, description, and branding configuration including logos and colors through the [`Brand`](https://shopify.dev/docs/api/storefront/2026-10/objects/Brand) object. Access store policies such as privacy, refund, shipping, and terms of service via [`ShopPolicy`](https://shopify.dev/docs/api/storefront/2026-10/objects/ShopPolicy), and the subscription policy via [`ShopPolicyWithDefault`](https://shopify.dev/docs/api/storefront/2026-10/objects/ShopPolicyWithDefault). [`PaymentSettings`](https://shopify.dev/docs/api/storefront/2026-10/objects/PaymentSettings) expose accepted card brands, supported digital wallets, and enabled presentment currencies. The object also includes the primary [`Domain`](https://shopify.dev/docs/api/storefront/2026-10/objects/Domain), countries the shop ships to, [`ShopPayInstallmentsPricing`](https://shopify.dev/docs/api/storefront/2026-10/objects/ShopPayInstallmentsPricing), and [`SocialLoginProvider`](https://shopify.dev/docs/api/storefront/2026-10/objects/SocialLoginProvider) options for customer accounts. * brand [Brand](https://shopify.dev/docs/api/storefront/latest/objects/Brand) The shop's branding configuration. * contact​Information [Shop​Policy](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicy) The shop's contact information. * customer​Account​Translations [\[Translation!\]](https://shopify.dev/docs/api/storefront/latest/objects/Translation) Translations for customer accounts. * customer​Account​Url [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The URL for the customer account (only present if shop has a customer account vanity domain). * description [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) A description of the shop. * id [ID!](https://shopify.dev/docs/api/storefront/latest/scalars/ID) non-null A globally-unique ID. * legal​Notice [Shop​Policy](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicy) The shop's legal notice. * metafield [Metafield](https://shopify.dev/docs/api/storefront/latest/objects/Metafield) Token access required A [custom field](https://shopify.dev/docs/apps/build/custom-data), including its `namespace` and `key`, that's associated with a Shopify resource for the purposes of adding and storing additional information. * key [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) required ### Arguments The identifier for the metafield. * namespace [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) The container the metafield belongs to. If omitted, the app-reserved namespace will be used. *** * metafields [\[Metafield\]!](https://shopify.dev/docs/api/storefront/latest/objects/Metafield) non-null Token access required A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. * identifiers [\[Has​Metafields​Identifier!\]!](https://shopify.dev/docs/api/storefront/latest/input-objects/HasMetafieldsIdentifier) required ### Arguments The list of metafields to retrieve by namespace and key. The input must not contain more than `250` values. *** * money​Format [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) non-null A string representing the way currency is formatted when the currency isn’t specified. * name [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) non-null The shop’s name. * payment​Settings [Payment​Settings!](https://shopify.dev/docs/api/storefront/latest/objects/PaymentSettings) non-null Settings related to payments. * primary​Domain [Domain!](https://shopify.dev/docs/api/storefront/latest/objects/Domain) non-null The primary domain of the shop’s Online Store. * privacy​Policy [Shop​Policy](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicy) The shop’s privacy policy. * refund​Policy [Shop​Policy](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicy) The shop’s refund policy. * shipping​Policy [Shop​Policy](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicy) The shop’s shipping policy. * ships​To​Countries [\[Country​Code!\]!](https://shopify.dev/docs/api/storefront/latest/enums/CountryCode) non-null Countries that the shop ships to. * shop​Pay​Installments​Pricing [Shop​Pay​Installments​Pricing](https://shopify.dev/docs/api/storefront/latest/objects/ShopPayInstallmentsPricing) Token access required The Shop Pay Installments pricing information for the shop. * social​Login​Providers [\[Social​Login​Provider!\]!](https://shopify.dev/docs/api/storefront/latest/objects/SocialLoginProvider) non-null The social login providers for customer accounts. * subscription​Policy [Shop​Policy​With​Default](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicyWithDefault) The shop’s subscription policy. * terms​Of​Sale [Shop​Policy](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicy) The shop's terms of sale. * terms​Of​Service [Shop​Policy](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicy) The shop’s terms of service. *** ## Examples * ### shop reference