---
title: segment - GraphQL Admin
description: >-
  Retrieves a customer
  [`Segment`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment)
  by ID. Segments are dynamic groups of customers that meet specific criteria
  defined through [ShopifyQL
  queries](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference).


  Use segments for targeted marketing campaigns, analyzing customer behavior, or
  creating personalized experiences. Each segment includes its name, creation
  date, and the query that defines which
  [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer)
  objects belong to it.
api_version: 2025-07
api_name: admin
type: query
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/2025-07/queries/segment'
  md: 'https://shopify.dev/docs/api/admin-graphql/2025-07/queries/segment.md'
---

# segment

query

Retrieves a customer [`Segment`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment) by ID. Segments are dynamic groups of customers that meet specific criteria defined through [ShopifyQL queries](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference).

Use segments for targeted marketing campaigns, analyzing customer behavior, or creating personalized experiences. Each segment includes its name, creation date, and the query that defines which [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) objects belong to it.

## Arguments

* id

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

  required

  Find a segment by ID.

***

## Possible returns

* Segment

  [Segment](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Segment)

  A group of [customers](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) that meet specific criteria defined through [ShopifyQL query](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference) conditions. Common use cases for segments include customer analytics, targeted marketing campaigns, and automated discount eligibility.

  The segment's [`query`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment#field-query) field contains ShopifyQL conditions that determine membership, such as purchase history, location, or engagement patterns. Tracks when the segment was created with [`creationDate`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment#field-creationDate) and when it was last modified with [`lastEditDate`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment#field-lastEditDate).

***

## Examples

* ### segment reference

## Query Reference

```graphql
{
  segment(id) {
    # segment fields
  }
}
```