---
title: page - Storefront API
description: >
  Retrieves a [`Page`](/docs/api/storefront/unstable/objects/Page) by its
  [`handle`](/docs/api/storefront/unstable/queries/page#arguments-handle) or
  [`id`](/docs/api/storefront/unstable/queries/page#arguments-id). Pages are
  static content pages that merchants display outside their product catalog,
  such as "About Us," "Contact," or policy pages.


  The returned page includes information such as the [HTML body
  content](/docs/api/storefront/unstable/queries/page#returns-Page.fields.body),
  [`SEO`](/docs/api/storefront/unstable/objects/SEO) information, and any
  associated [`Metafield`](/docs/api/storefront/unstable/objects/Metafield)
  objects.
api_version: unstable
api_name: storefront
source_url:
  html: 'https://shopify.dev/docs/api/storefront/unstable/queries/page'
  md: 'https://shopify.dev/docs/api/storefront/unstable/queries/page.md'
---

# page

query

Retrieves a [`Page`](https://shopify.dev/docs/api/storefront/unstable/objects/Page) by its [`handle`](https://shopify.dev/docs/api/storefront/unstable/queries/page#arguments-handle) or [`id`](https://shopify.dev/docs/api/storefront/unstable/queries/page#arguments-id). Pages are static content pages that merchants display outside their product catalog, such as "About Us," "Contact," or policy pages.

The returned page includes information such as the [HTML body content](https://shopify.dev/docs/api/storefront/unstable/queries/page#returns-Page.fields.body), [`SEO`](https://shopify.dev/docs/api/storefront/unstable/objects/SEO) information, and any associated [`Metafield`](https://shopify.dev/docs/api/storefront/unstable/objects/Metafield) objects.

## Arguments

* handle

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  The handle of the `Page`.

* id

  [ID](https://shopify.dev/docs/api/storefront/unstable/scalars/ID)

  The ID of the `Page`.

***

## Possible returns

* Page

  [Page](https://shopify.dev/docs/api/storefront/unstable/objects/Page)

  A [custom content page](https://help.shopify.com/manual/online-store/add-edit-pages) on a merchant's store. Pages display HTML-formatted content, such as "About Us", contact details, or store policies.

  Each page has a unique [`handle`](https://shopify.dev/docs/api/storefront/unstable/objects/Page#field-Page.fields.handle) for URL routing and includes [`SEO`](https://shopify.dev/docs/api/storefront/unstable/objects/SEO) information for search engine optimization. Pages support [`Metafield`](https://shopify.dev/docs/api/storefront/unstable/objects/Metafield) attachments for storing additional custom data.

  * body

    [HTML!](https://shopify.dev/docs/api/storefront/unstable/scalars/HTML)

    non-null

    The description of the page, complete with HTML formatting.

  * body​Summary

    [String!](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

    non-null

    Summary of the page body.

  * created​At

    [Date​Time!](https://shopify.dev/docs/api/storefront/unstable/scalars/DateTime)

    non-null

    The timestamp of the page creation.

  * handle

    [String!](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

    non-null

    A human-friendly unique string for the page automatically generated from its title.

  * id

    [ID!](https://shopify.dev/docs/api/storefront/unstable/scalars/ID)

    non-null

    A globally-unique ID.

  * metafield

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

      required

      The identifier for the metafield.

    ***

  * metafields

    [\[Metafield\]!](https://shopify.dev/docs/api/storefront/unstable/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/unstable/input-objects/HasMetafieldsIdentifier)

      required

      ### Arguments

      The list of metafields to retrieve by namespace and key.

      The input must not contain more than `250` values.

    ***

  * online​Store​Url

    [URL](https://shopify.dev/docs/api/storefront/unstable/scalars/URL)

    The URL used for viewing the resource on the shop's Online Store. Returns `null` if the resource is currently not published to the Online Store sales channel.

  * seo

    [SEO](https://shopify.dev/docs/api/storefront/unstable/objects/SEO)

    The page's SEO information.

  * title

    [String!](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

    non-null

    The title of the page.

  * tracking​Parameters

    [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

    URL parameters to be added to a page URL to track the origin of on-site search traffic for [analytics reporting](https://help.shopify.com/manual/reports-and-analytics/shopify-reports/report-types/default-reports/behaviour-reports). Returns a result when accessed through the [search](https://shopify.dev/docs/api/storefront/unstable/queries/search) or [predictiveSearch](https://shopify.dev/docs/api/storefront/unstable/queries/predictiveSearch) queries, otherwise returns null.

  * updated​At

    [Date​Time!](https://shopify.dev/docs/api/storefront/unstable/scalars/DateTime)

    non-null

    The timestamp of the latest page update.

***

## Examples

* ### page reference