---
title: shop - Storefront API
description: The shop associated with the storefront access token.
api_version: 2025-10
api_name: storefront
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/queries/Shop
  md: https://shopify.dev/docs/api/storefront/latest/queries/Shop.md
---

# shop

query

The shop associated with the storefront access token.

## Possible returns

* Shop

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

  Shop represents a collection of the general settings and information about the shop.

  * brand

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

    The shop's branding configuration.

  * 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.

  * 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.

    * namespace

      [String](https://shopify.dev/docs/api/storefront/latest/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/latest/scalars/String)

      required

      The identifier for the metafield.

    ***

  * 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.

  * subscription​Policy

    [Shop​Policy​With​Default](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicyWithDefault)

    The shop’s subscription policy.

  * terms​Of​Service

    [Shop​Policy](https://shopify.dev/docs/api/storefront/latest/objects/ShopPolicy)

    The shop’s terms of service.

***

## Examples

* ### shop reference

## Query Reference

```graphql
{
  shop {
    # shop fields
  }
}
```