---
title: Segment - GraphQL Admin
description: A dynamic collection of customers based on specific criteria.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/Segment.md
---

# Segment

object

Requires `read_customers` access scope. Also: The user must not have restricted access.

A dynamic collection of customers based on specific criteria.

## Fields

* creation​Date

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the segment was added to the store.

* id

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

  non-null

  A globally-unique ID.

* last​Edit​Date

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the segment was last updated.

* name

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

  non-null

  The name of the segment.

* query

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

  non-null

  A precise definition of the segment. The definition is composed of a combination of conditions on facts about customers.

***

## Map

### Fields and connections with this object

* {}[DiscountCustomerSegments.segments](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCustomerSegments#field-DiscountCustomerSegments.fields.segments)
* {}[PriceRuleCustomerSelection.segments](https://shopify.dev/docs/api/admin-graphql/latest/objects/PriceRuleCustomerSelection#field-PriceRuleCustomerSelection.fields.segments)
* <->[SegmentConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/SegmentConnection#returns-nodes)
* {}[SegmentEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/SegmentEdge#field-SegmentEdge.fields.node)

***

## Queries

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

  query

  The Customer Segment.

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

  query

  A list of a shop's segments.

***

## \<?>Segment Queries

### Queried by

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

***

## Mutations

* [segment​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/segmentCreate)

  mutation

  Creates a segment.

* [segment​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/segmentUpdate)

  mutation

  Updates a segment.

***

## <\~> Segment Mutations

### Mutated by

* <\~>[segment​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/segmentCreate)
* <\~>[segment​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/segmentUpdate)

***

## Interfaces

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

  interface

***

## ||-Segment Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)