--- title: Page - GraphQL Admin description: >- A standalone content page in the online store. Pages display HTML-formatted content for informational pages like "About Us", contact information, or shipping policies. Each page has a unique handle for URL routing and supports custom template suffixes for specialized layouts. Pages can be published or hidden, and include creation and update timestamps. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Page' md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/Page.md' --- # Page object Requires `read_content` access scope or `read_online_store_pages` access scope. A standalone content page in the online store. Pages display HTML-formatted content for informational pages like "About Us", contact information, or shipping policies. Each page has a unique handle for URL routing and supports custom template suffixes for specialized layouts. Pages can be published or hidden, and include creation and update timestamps. ## Fields * body [HTML!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/HTML) non-null The text content of the page, complete with HTML markup. * body​Summary [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The first 150 characters of the page body. If the page body contains more than 150 characters, additional characters are truncated by ellipses. * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time (ISO 8601 format) of the page creation. * default​Cursor [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null A default [cursor](https://shopify.dev/api/usage/pagination-graphql) that returns the single next record, sorted ascending by ID. * events [Event​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/EventConnection) non-null The paginated list of events associated with the host subject. * handle [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null A unique, human-friendly string for the page. In themes, the Liquid templating language refers to a page by its handle. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * is​Published [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether or not the page is visible. * metafield [Metafield](https://shopify.dev/docs/api/admin-graphql/latest/objects/Metafield) 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. * metafields [Metafield​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MetafieldConnection) non-null A list of [custom fields](https://shopify.dev/docs/apps/build/custom-data) that a merchant associates with a Shopify resource. * published​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) The date and time (ISO 8601 format) when the page became or will become visible. Returns null when the page isn't visible. * template​Suffix [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The suffix of the template that's used to render the page. * title [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null Title of the page. * translations [\[Translation!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/Translation) non-null The published translations associated with the resource. * updated​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time (ISO 8601 format) of the latest page update. * metafield​Definitions [Metafield​Definition​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/MetafieldDefinitionConnection) non-nullDeprecated *** ## Map ### Fields and connections with this object * <->[PageConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/PageConnection#returns-nodes) * {}[PageEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/PageEdge#field-PageEdge.fields.node) ### Possible type in * [Metafield​Reference](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReference) * [Metafield​Referencer](https://shopify.dev/docs/api/admin-graphql/latest/unions/MetafieldReferencer) *** ## Queries * [page](https://shopify.dev/docs/api/admin-graphql/latest/queries/page) query Returns a `Page` resource by ID. * [pages](https://shopify.dev/docs/api/admin-graphql/latest/queries/pages) query A paginated list of pages from the online store. [`Page`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Page) objects are content pages that merchants create to provide information to customers, such as "About Us", "Contact", or policy pages. The query supports filtering with a [search query](https://shopify.dev/docs/api/usage/search-syntax) and sorting by various criteria. Advanced filtering is available through saved searches using the [`savedSearchId`](https://shopify.dev/docs/api/admin-graphql/latest/queries/pages#arguments-savedSearchId) argument. *** ## \Page Queries ### Queried by * \[page](https://shopify.dev/docs/api/admin-graphql/latest/queries/page) * \[pages](https://shopify.dev/docs/api/admin-graphql/latest/queries/pages) *** ## Mutations * [page​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/pageCreate) mutation Creates a [`Page`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Page) for the online store. Pages contain custom content like "About Us" or "Contact" information that merchants display outside their product catalog. The page requires a [`title`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Page#field-Page.fields.title) and can include HTML content, publishing settings, and custom [template suffixes](https://shopify.dev/docs/api/admin-graphql/latest/objects/Page#field-Page.fields.templateSuffix). You can control visibility through the [`isPublished`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Page#field-Page.fields.isPublished) flag or schedule publication with a specific date. The mutation returns the complete page object upon successful creation or validation errors if the input is invalid. * [page​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/pageUpdate) mutation Updates an existing page's content and settings. For example, merchants can update their "Shipping Policy" page when rates change, or refresh their "About Us" page with new team information. Use the `pageUpdate` mutation to: * Update page content and titles * Modify publication status * Change page handles for URL structure * Adjust template settings The mutation supports partial updates, allowing specific changes while preserving other page properties. *** ## <\~> Page Mutations ### Mutated by * <\~>[page​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/pageCreate) * <\~>[page​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/pageUpdate) *** ## Interfaces * * [Has​Events](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasEvents) interface * [Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions) interface * [Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) interface * [Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations) interface * [Navigable](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Navigable) interface * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-Page Implements ### Implements * ||-[Has​Events](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasEvents) * ||-[Has​Metafield​Definitions](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafieldDefinitions) * ||-[Has​Metafields](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasMetafields) * ||-[Has​Published​Translations](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/HasPublishedTranslations) * ||-[Navigable](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Navigable) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)