--- title: QueryRoot - Storefront API description: The schema’s entry-point for queries. This acts as the public, top-level API from which all queries must start. api_version: 2025-10 api_name: storefront type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/storefront/latest/objects/queryroot md: https://shopify.dev/docs/api/storefront/latest/objects/queryroot.md --- # Query​Root object The schema’s entry-point for queries. This acts as the public, top-level API from which all queries must start. ## Fields * article [Article](https://shopify.dev/docs/api/storefront/latest/objects/Article) Fetch a specific Article by its ID. * articles [Article​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/ArticleConnection) non-null List of the shop's articles. * blog [Blog](https://shopify.dev/docs/api/storefront/latest/objects/Blog) Fetch a specific `Blog` by one of its unique attributes. * blogs [Blog​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/BlogConnection) non-null List of the shop's blogs. * cart [Cart](https://shopify.dev/docs/api/storefront/latest/objects/Cart) Retrieve a cart by its ID. For more information, refer to [Manage a cart with the Storefront API](https://shopify.dev/custom-storefronts/cart/manage). * collection [Collection](https://shopify.dev/docs/api/storefront/latest/objects/Collection) Fetch a specific `Collection` by one of its unique attributes. * collections [Collection​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/CollectionConnection) non-null List of the shop’s collections. * customer [Customer](https://shopify.dev/docs/api/storefront/latest/objects/Customer) The customer associated with the given access token. Tokens are obtained by using the [`customerAccessTokenCreate` mutation](https://shopify.dev/docs/api/storefront/latest/mutations/customerAccessTokenCreate). * localization [Localization!](https://shopify.dev/docs/api/storefront/latest/objects/Localization) non-null Returns the localized experiences configured for the shop. * locations [Location​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/LocationConnection) non-null List of the shop's locations that support in-store pickup. When sorting by distance, you must specify a location via the `near` argument. * menu [Menu](https://shopify.dev/docs/api/storefront/latest/objects/Menu) Retrieve a [navigation menu](https://help.shopify.com/manual/online-store/menus-and-links) by its handle. * metaobject [Metaobject](https://shopify.dev/docs/api/storefront/latest/objects/Metaobject) Fetch a specific Metaobject by one of its unique identifiers. * metaobjects [Metaobject​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/MetaobjectConnection) non-null All active metaobjects for the shop. * node [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node) Returns a specific node by ID. * nodes [\[Node\]!](https://shopify.dev/docs/api/storefront/latest/interfaces/Node) non-null Returns the list of nodes with the given IDs. * page [Page](https://shopify.dev/docs/api/storefront/latest/objects/Page) Fetch a specific `Page` by one of its unique attributes. * pages [Page​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/PageConnection) non-null List of the shop's pages. * payment​Settings [Payment​Settings!](https://shopify.dev/docs/api/storefront/latest/objects/PaymentSettings) non-null Settings related to payments. * predictive​Search [Predictive​Search​Result](https://shopify.dev/docs/api/storefront/latest/objects/PredictiveSearchResult) List of the predictive search results. * product [Product](https://shopify.dev/docs/api/storefront/latest/objects/Product) Fetch a specific `Product` by one of its unique attributes. * product​Recommendations [\[Product!\]](https://shopify.dev/docs/api/storefront/latest/objects/Product) Find recommended products related to a given `product_id`. To learn more about how recommendations are generated, see [*Showing product recommendations on product pages*](https://help.shopify.com/themes/development/recommended-products). * products [Product​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/ProductConnection) non-null Returns a list of the shop's products. For storefront search, use the [`search`](https://shopify.dev/docs/api/storefront/latest/queries/search) query. * product​Tags [String​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/StringConnection) non-null Tags added to products. Additional access scope required: unauthenticated\_read\_product\_tags. * product​Types [String​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/StringConnection) non-null List of product types for the shop's products that are published to your app. * public​Api​Versions [\[Api​Version!\]!](https://shopify.dev/docs/api/storefront/latest/objects/ApiVersion) non-null The list of public Storefront API versions, including supported, release candidate and unstable versions. * search [Search​Result​Item​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/SearchResultItemConnection) non-null List of the search results. * shop [Shop!](https://shopify.dev/docs/api/storefront/latest/objects/Shop) non-null The shop associated with the storefront access token. * sitemap [Sitemap!](https://shopify.dev/docs/api/storefront/latest/objects/Sitemap) non-null Contains all fields required to generate sitemaps. * url​Redirects [Url​Redirect​Connection!](https://shopify.dev/docs/api/storefront/latest/connections/UrlRedirectConnection) non-null A list of redirects for a shop. ### Deprecated fields * blog​By​Handle [Blog](https://shopify.dev/docs/api/storefront/latest/objects/Blog) Deprecated * collection​By​Handle [Collection](https://shopify.dev/docs/api/storefront/latest/objects/Collection) Deprecated * page​By​Handle [Page](https://shopify.dev/docs/api/storefront/latest/objects/Page) Deprecated * product​By​Handle [Product](https://shopify.dev/docs/api/storefront/latest/objects/Product) Deprecated *** ## Map No referencing types