--- title: Page - Storefront API description: |- 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`](/docs/api/storefront/2026-10/objects/Page#field-Page.fields.handle) for URL routing and includes [`SEO`](/docs/api/storefront/2026-10/objects/SEO) information for search engine optimization. Pages support [`Metafield`](/docs/api/storefront/2026-10/objects/Metafield) attachments for storing additional custom data. api_version: 2026-10 source_url: html: https://shopify.dev/docs/api/storefront/latest/objects/page md: https://shopify.dev/docs/api/storefront/latest/objects/page.md --- # Page object Requires `unauthenticated_read_content` access scope. 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/2026-10/objects/Page#field-Page.fields.handle) for URL routing and includes [`SEO`](https://shopify.dev/docs/api/storefront/2026-10/objects/SEO) information for search engine optimization. Pages support [`Metafield`](https://shopify.dev/docs/api/storefront/2026-10/objects/Metafield) attachments for storing additional custom data. ## Fields * body [HTML!](https://shopify.dev/docs/api/storefront/latest/scalars/HTML) non-null The description of the page, complete with HTML formatting. * body​Summary [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) non-null Summary of the page body. * created​At [Date​Time!](https://shopify.dev/docs/api/storefront/latest/scalars/DateTime) non-null The timestamp of the page creation. * handle [String!](https://shopify.dev/docs/api/storefront/latest/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/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. * 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. *** * online​Store​Url [URL](https://shopify.dev/docs/api/storefront/latest/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/latest/objects/SEO) The page's SEO information. * title [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) non-null The title of the page. * tracking​Parameters [String](https://shopify.dev/docs/api/storefront/latest/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/2026-10/queries/search) or [predictiveSearch](https://shopify.dev/docs/api/storefront/2026-10/queries/predictiveSearch) queries, otherwise returns null. * updated​At [Date​Time!](https://shopify.dev/docs/api/storefront/latest/scalars/DateTime) non-null The timestamp of the latest page update. *** ## Map ### Fields and connections with this object * [PageConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/PageConnection#returns-nodes) * [PageEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/PageEdge#field-PageEdge.fields.node) * [PredictiveSearchResult.pages](https://shopify.dev/docs/api/storefront/latest/objects/PredictiveSearchResult#field-PredictiveSearchResult.fields.pages) ### Possible type in * [Menu​Item​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MenuItemResource) * [Metafield​Parent​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldParentResource) * [Metafield​Reference](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldReference) * [Search​Result​Item](https://shopify.dev/docs/api/storefront/latest/unions/SearchResultItem) *** ## Queries * [page](https://shopify.dev/docs/api/storefront/latest/queries/page) query Retrieves a [`Page`](https://shopify.dev/docs/api/storefront/2026-10/objects/Page) by its [`handle`](https://shopify.dev/docs/api/storefront/2026-10/queries/page#arguments-handle) or [`id`](https://shopify.dev/docs/api/storefront/2026-10/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/2026-10/queries/page#returns-Page.fields.body), [`SEO`](https://shopify.dev/docs/api/storefront/2026-10/objects/SEO) information, and any associated [`Metafield`](https://shopify.dev/docs/api/storefront/2026-10/objects/Metafield) objects. * handle [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) ### Arguments The handle of the `Page`. * id [ID](https://shopify.dev/docs/api/storefront/latest/scalars/ID) The ID of the `Page`. *** * [pages](https://shopify.dev/docs/api/storefront/latest/queries/pages) query Returns a paginated list of the shop's content [pages](https://shopify.dev/docs/api/storefront/2026-10/objects/Page). Pages are custom HTML content like "About Us", "Contact", or policy information that merchants display outside their product catalog. * after [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) ### Arguments Returns the elements that come after the specified cursor. * before [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) Returns the elements that come before the specified cursor. * first [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int) Returns up to the first `n` elements from the list. * last [Int](https://shopify.dev/docs/api/storefront/latest/scalars/Int) Returns up to the last `n` elements from the list. * query [String](https://shopify.dev/docs/api/storefront/latest/scalars/String) Apply one or multiple filters to the query. Refer to the detailed [search syntax](https://shopify.dev/api/usage/search-syntax) for more information about using filters. * created\_at * handle * title * updated\_at * reverse [Boolean](https://shopify.dev/docs/api/storefront/latest/scalars/Boolean) Default:false Reverse the order of the underlying list. * sort​Key [Page​Sort​Keys](https://shopify.dev/docs/api/storefront/latest/enums/PageSortKeys) Default:ID Sort the underlying list by the given key. *** * [page​By​Handle](https://shopify.dev/docs/api/storefront/latest/queries/pageByHandle) query Deprecated * handle [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String) required ### Arguments The handle of the page. *** *** ## Page Queries ### Queried by * [page](https://shopify.dev/docs/api/storefront/latest/queries/page) * [pages](https://shopify.dev/docs/api/storefront/latest/queries/pages) *** ## Interfaces * * [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields) interface * [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node) interface * [Online​Store​Publishable](https://shopify.dev/docs/api/storefront/latest/interfaces/OnlineStorePublishable) interface * [Trackable](https://shopify.dev/docs/api/storefront/latest/interfaces/Trackable) interface *** ## Page Implements ### Implements * [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields) * [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node) * [Online​Store​Publishable](https://shopify.dev/docs/api/storefront/latest/interfaces/OnlineStorePublishable) * [Trackable](https://shopify.dev/docs/api/storefront/latest/interfaces/Trackable)