---
title: pages - Storefront API
description: |-
  Returns a paginated list of the shop's content
  [pages](/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.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/queries/pages'
  md: 'https://shopify.dev/docs/api/storefront/latest/queries/pages.md'
api_name: storefront
api_type: graphql
type: query
---

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

## PageConnection arguments

[PageConnection!](https://shopify.dev/docs/api/storefront/latest/connections/PageConnection)

* after

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

  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.

***

## Possible returns

* edges

  [\[Page​Edge!\]!](https://shopify.dev/docs/api/storefront/latest/objects/PageEdge)

  non-null

  A list of edges.

* nodes

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

  non-null

  A list of the nodes contained in PageEdge.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/storefront/latest/objects/PageInfo)

  non-null

  Information to aid in pagination.

***

## Examples

* ### pages reference