--- title: Shop - Storefront API description: > 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`](/docs/api/storefront/2025-07/objects/Brand) object. Access store policies such as privacy, refund, shipping, and terms of service via [`ShopPolicy`](/docs/api/storefront/2025-07/objects/ShopPolicy), and the subscription policy via [`ShopPolicyWithDefault`](/docs/api/storefront/2025-07/objects/ShopPolicyWithDefault). [`PaymentSettings`](/docs/api/storefront/2025-07/objects/PaymentSettings) expose accepted card brands, supported digital wallets, and enabled presentment currencies. The object also includes the primary [`Domain`](/docs/api/storefront/2025-07/objects/Domain), countries the shop ships to, [`ShopPayInstallmentsPricing`](/docs/api/storefront/2025-07/objects/ShopPayInstallmentsPricing), and [`SocialLoginProvider`](/docs/api/storefront/2025-07/objects/SocialLoginProvider) options for customer accounts. api_version: 2025-07 api_name: storefront type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/storefront/2025-07/objects/Shop' md: 'https://shopify.dev/docs/api/storefront/2025-07/objects/Shop.md' --- # Shop object Requires `unauthenticated_read_product_listings` access scope. 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/2025-07/objects/Brand) object. Access store policies such as privacy, refund, shipping, and terms of service via [`ShopPolicy`](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPolicy), and the subscription policy via [`ShopPolicyWithDefault`](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPolicyWithDefault). [`PaymentSettings`](https://shopify.dev/docs/api/storefront/2025-07/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/2025-07/objects/Domain), countries the shop ships to, [`ShopPayInstallmentsPricing`](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPayInstallmentsPricing), and [`SocialLoginProvider`](https://shopify.dev/docs/api/storefront/2025-07/objects/SocialLoginProvider) options for customer accounts. ## Fields * brand [Brand](https://shopify.dev/docs/api/storefront/2025-07/objects/Brand) The shop's branding configuration. * customer​Account​Url [String](https://shopify.dev/docs/api/storefront/2025-07/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/2025-07/scalars/String) A description of the shop. * id [ID!](https://shopify.dev/docs/api/storefront/2025-07/scalars/ID) non-null A globally-unique ID. * metafield [Metafield](https://shopify.dev/docs/api/storefront/2025-07/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. * namespace [String](https://shopify.dev/docs/api/storefront/2025-07/scalars/String) ### Arguments The container the metafield belongs to. If omitted, the app-reserved namespace will be used. * key [String!](https://shopify.dev/docs/api/storefront/2025-07/scalars/String) required The identifier for the metafield. *** * metafields [\[Metafield\]!](https://shopify.dev/docs/api/storefront/2025-07/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/2025-07/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/2025-07/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/2025-07/scalars/String) non-null The shop’s name. * payment​Settings [Payment​Settings!](https://shopify.dev/docs/api/storefront/2025-07/objects/PaymentSettings) non-null Settings related to payments. * primary​Domain [Domain!](https://shopify.dev/docs/api/storefront/2025-07/objects/Domain) non-null The primary domain of the shop’s Online Store. * privacy​Policy [Shop​Policy](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPolicy) The shop’s privacy policy. * refund​Policy [Shop​Policy](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPolicy) The shop’s refund policy. * shipping​Policy [Shop​Policy](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPolicy) The shop’s shipping policy. * ships​To​Countries [\[Country​Code!\]!](https://shopify.dev/docs/api/storefront/2025-07/enums/CountryCode) non-null Countries that the shop ships to. * shop​Pay​Installments​Pricing [Shop​Pay​Installments​Pricing](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPayInstallmentsPricing) Token access required The Shop Pay Installments pricing information for the shop. * subscription​Policy [Shop​Policy​With​Default](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPolicyWithDefault) The shop’s subscription policy. * terms​Of​Service [Shop​Policy](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPolicy) The shop’s terms of service. *** ## Map ### Possible type in * [Metafield​Parent​Resource](https://shopify.dev/docs/api/storefront/2025-07/unions/MetafieldParentResource) *** ## Queries * [shop](https://shopify.dev/docs/api/storefront/2025-07/queries/shop) query Returns the [`Shop`](https://shopify.dev/docs/api/storefront/2025-07/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/2025-07/objects/PaymentSettings), [`Brand`](https://shopify.dev/docs/api/storefront/2025-07/objects/Brand) configuration, and shipping destinations. It also exposes [`ShopPayInstallmentsPricing`](https://shopify.dev/docs/api/storefront/2025-07/objects/ShopPayInstallmentsPricing) and [`SocialLoginProvider`](https://shopify.dev/docs/api/storefront/2025-07/objects/SocialLoginProvider) options for customer accounts. *** ## Shop Queries ### Queried by * [shop](https://shopify.dev/docs/api/storefront/2025-07/queries/shop) *** ## Interfaces * * [Has​Metafields](https://shopify.dev/docs/api/storefront/2025-07/interfaces/HasMetafields) interface * [Node](https://shopify.dev/docs/api/storefront/2025-07/interfaces/Node) interface *** ## Shop Implements ### Implements * [Has​Metafields](https://shopify.dev/docs/api/storefront/2025-07/interfaces/HasMetafields) * [Node](https://shopify.dev/docs/api/storefront/2025-07/interfaces/Node)