---
title: customerSegmentMembersCount - GraphQL Admin
description: >-
  Returns the total number of customers who match the criteria defined in a
  customer segment. This count provides real-time visibility into segment size
  for targeting and analysis purposes.


  For example, check the size of a "High-Value Customers" segment before
  launching a VIP program.


  The count reflects current segment membership based on the segment's filter
  criteria, updating as customer data changes and new customers meet or no
  longer meet the segment conditions.
api_version: unstable
api_name: admin
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/queries/customerSegmentMembersCount
  md: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/queries/customerSegmentMembersCount.md
---

# customer​Segment​Members​Count

query

Requires `read_customers` access scope.

Returns the total number of customers who match the criteria defined in a customer segment. This count provides real-time visibility into segment size for targeting and analysis purposes.

For example, check the size of a "High-Value Customers" segment before launching a VIP program.

The count reflects current segment membership based on the segment's filter criteria, updating as customer data changes and new customers meet or no longer meet the segment conditions.

## Arguments

* query

  [String](https://shopify.dev/docs/api/admin-graphql/unstable/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/unstable/scalars/ID)

  The ID of the segment members query.

* segment​Id

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

  The ID of the segment.

***

## Possible returns

* Count

  [Count](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Count)

  Details for count of elements.

***

## Examples

* ### customerSegmentMembersCount reference

## Query Reference

```graphql
{
  customerSegmentMembersCount {
    # customerSegmentMembersCount fields
  }
}
```