---
title: customerSegmentMembers - GraphQL Admin
description: >-
  The list of members, such as customers, that's associated with an individual
  segment.

  The maximum page size is 1000.
api_version: 2024-10
api_name: admin
type: query
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/queries/customerSegmentMembers
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/queries/customerSegmentMembers.txt
---

# customer​Segment​Members

query

The list of members, such as customers, that's associated with an individual segment. The maximum page size is 1000.

## CustomerSegmentMemberConnection arguments

[CustomerSegmentMemberConnection!](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/CustomerSegmentMemberConnection)

* after

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

* before

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

* first

  [Int](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/Int)

  The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

* last

  [Int](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/Int)

  The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

* query

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  The query that's used to filter the members. The query is composed of a combination of conditions on facts about customers such as `email_subscription_status = 'SUBSCRIBED'` with [this syntax](https://shopify.dev/api/shopifyql/segment-query-language-reference).

* query​Id

  [ID](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

  The ID of the segment members query.

* reverse

  [Boolean](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/Boolean)

  Default:false

  Reverse the order of the list. The sorting behaviour defaults to ascending order.

* segment​Id

  [ID](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

  The ID of the segment.

* sort​Key

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  Sort the list by a given key. Valid values: • `created_at` - Sort by customer creation date • `first_order_date` - Sort by the date of the customer's first order • `last_abandoned_order_date` - Sort by the date of the customer's last abandoned checkout • `last_order_date` - Sort by the date of the customer's most recent order • `number_of_orders` - Sort by the total number of orders placed by the customer • `amount_spent` - Sort by the total amount the customer has spent across all orders

  Use with the `reverse` parameter to control sort direction (ascending by default, descending when reverse=true).

* timezone

  [String](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  The timezone that's used to interpret relative date arguments. The timezone defaults to UTC if the timezone isn't provided.

***

## Possible returns

* edges

  [\[Customer​Segment​Member​Edge!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CustomerSegmentMemberEdge)

  non-null

  A list of edges.

* page​Info

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

  non-null

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

* statistics

  [Segment​Statistics!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentStatistics)

  non-null

  The statistics for a given segment.

* total​Count

  [Int!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/Int)

  non-null

  The total number of members in a given segment.

***

## Examples

* ### customerSegmentMembers reference

## Query Reference

```graphql
{
  customerSegmentMembers {
    # customerSegmentMembers fields
  }
}
```