---
title: OrderConnection - Storefront API
description: An auto-generated type for paginating through multiple Orders.
api_version: 2026-07
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/connections/OrderConnection'
  md: >-
    https://shopify.dev/docs/api/storefront/latest/connections/OrderConnection.md
api_name: storefront
api_type: graphql
type: connection
---

# Order​Connection

connection

An auto-generated type for paginating through multiple Orders.

## Fields with this connection

* [Customer.orders](https://shopify.dev/docs/api/storefront/latest/objects/Customer#field-Customer.fields.orders)

  OBJECT

  A customer account with the shop. Includes data such as contact information, [addresses](https://shopify.dev/docs/api/storefront/current/objects/MailingAddress) and marketing preferences for logged-in customers, so they don't have to provide these details at every checkout.

  Access the customer through the [`customer`](https://shopify.dev/docs/api/storefront/current/queries/customer) query using a customer access token obtained from the [`customerAccessTokenCreate`](https://shopify.dev/docs/api/storefront/current/mutations/customerAccessTokenCreate) mutation.

  The object implements the [`HasMetafields`](https://shopify.dev/docs/api/storefront/current/interfaces/HasMetafields) interface, enabling retrieval of [custom data](https://shopify.dev/docs/apps/build/custom-data) associated with the customer.

***

## Possible returns

* edges

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

  non-null

  A list of edges.

* nodes

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

  non-null

  A list of the nodes contained in OrderEdge.

* page​Info

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

  non-null

  Information to aid in pagination.

* total​Count

  [Unsigned​Int64!](https://shopify.dev/docs/api/storefront/latest/scalars/UnsignedInt64)

  non-null

  The total count of Orders.

***

## Map

### Fields with this connection

* [Customer.orders](https://shopify.dev/docs/api/storefront/latest/objects/Customer#field-Customer.fields.orders)

### Possible returns

* [Order​Connection.edges](https://shopify.dev/docs/api/storefront/latest/connections/OrderConnection#returns-edges)
* [Order​Connection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/OrderConnection#returns-nodes)
* [Order​Connection.pageInfo](https://shopify.dev/docs/api/storefront/latest/connections/OrderConnection#returns-pageInfo)
* [Order​Connection.totalCount](https://shopify.dev/docs/api/storefront/latest/connections/OrderConnection#returns-totalCount)