---
title: CustomerConnection - GraphQL Admin
description: An auto-generated type for paginating through multiple Customers.
api_version: 2025-10
api_name: admin
type: connection
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/connections/customerconnection
  md: https://shopify.dev/docs/api/admin-graphql/latest/connections/customerconnection.md
---

# Customer​Connection

connection

An auto-generated type for paginating through multiple Customers.

## Fields with this connection

* [Price​Rule​Customer​Selection.customers](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceRuleCustomerSelection#field-PriceRuleCustomerSelection.fields.customers)

  OBJECT

  A selection of customers for whom the price rule applies.

* [Shop.customers](https://shopify.dev/docs/api/admin-graphql/latest/objects/Shop#field-Shop.fields.customers)

  OBJECT

  Deprecated

***

## Queries with this connection

* [customers](https://shopify.dev/docs/api/admin-graphql/latest/queries/customers)

  query

  Returns a list of [customers](https://shopify.dev/api/admin-graphql/latest/objects/Customer) in your Shopify store, including key information such as name, email, location, and purchase history. Use this query to segment your audience, personalize marketing campaigns, or analyze customer behavior by applying filters based on location, order history, marketing preferences and tags. The `customers` query supports [pagination](https://shopify.dev/api/usage/pagination-graphql) and [sorting](https://shopify.dev/api/admin-graphql/latest/enums/CustomerSortKeys).

***

## Possible returns

* edges

  [\[Customer​Edge!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEdge)

  non-null

  The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.

* nodes

  [\[Customer!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer)

  non-null

  A list of nodes that are contained in CustomerEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve.

* page​Info

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

  non-null

  An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page.

***

## Map

### Fields with this connection

* {}[Price​Rule​Customer​Selection.customers](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceRuleCustomerSelection#field-PriceRuleCustomerSelection.fields.customers)

### Queries with this connection

* \<?>[customers](https://shopify.dev/docs/api/admin-graphql/latest/queries/customers)

### Possible returns

* <->[Customer​Connection.edges](https://shopify.dev/docs/api/admin-graphql/latest/connections/CustomerConnection#returns-edges)
* <->[Customer​Connection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/CustomerConnection#returns-nodes)
* <->[Customer​Connection.pageInfo](https://shopify.dev/docs/api/admin-graphql/latest/connections/CustomerConnection#returns-pageInfo)