---
title: SegmentFilter - GraphQL Admin
description: The filters used in segment queries associated with a shop.
api_version: 2024-10
api_name: admin
type: interface
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/SegmentFilter'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/interfaces/SegmentFilter.txt
---

# Segment​Filter

interface

Requires `read_customers` access scope.

The filters used in segment queries associated with a shop.

## Fields

* localized​Name

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

  non-null

  The localized name of the filter.

* multi​Value

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

  non-null

  Whether a file can have multiple values for a single customer.

* query​Name

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

  non-null

  The query name of the filter.

***

## Types implemented in

* [Segment​Association​Filter](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentAssociationFilter)

  OBJECT

  A filter that takes a value that's associated with an object. For example, the `tags` field is associated with the [`Customer`](https://shopify.dev/api/admin-graphql/latest/objects/Customer) object.

  * localized​Name

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

    non-null

    The localized name of the filter.

  * multi​Value

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

    non-null

    Whether a file can have multiple values for a single customer.

  * query​Name

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

    non-null

    The query name of the filter.

* [Segment​Boolean​Filter](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentBooleanFilter)

  OBJECT

  A filter with a Boolean value that's been added to a segment query.

  * localized​Name

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

    non-null

    The localized name of the filter.

  * multi​Value

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

    non-null

    Whether a file can have multiple values for a single customer.

  * query​Name

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

    non-null

    The query name of the filter.

* [Segment​Date​Filter](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentDateFilter)

  OBJECT

  A filter with a date value that's been added to a segment query.

  * localized​Name

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

    non-null

    The localized name of the filter.

  * multi​Value

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

    non-null

    Whether a file can have multiple values for a single customer.

  * query​Name

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

    non-null

    The query name of the filter.

* [Segment​Enum​Filter](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentEnumFilter)

  OBJECT

  A filter with a set of possible values that's been added to a segment query.

  * localized​Name

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

    non-null

    The localized name of the filter.

  * multi​Value

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

    non-null

    Whether a file can have multiple values for a single customer.

  * query​Name

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

    non-null

    The query name of the filter.

* [Segment​Event​Filter](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentEventFilter)

  OBJECT

  A filter that's used to segment customers based on the date that an event occured. For example, the `product_bought` event filter allows you to segment customers based on what products they've bought.

  * localized​Name

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

    non-null

    The localized name of the filter.

  * multi​Value

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

    non-null

    Whether a file can have multiple values for a single customer.

  * parameters

    [\[Segment​Event​Filter​Parameter!\]!](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentEventFilterParameter)

    non-null

    The parameters for an event segment filter.

  * query​Name

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

    non-null

    The query name of the filter.

  * return​Value​Type

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

    non-null

    The return value type for an event segment filter.

* [Segment​Float​Filter](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentFloatFilter)

  OBJECT

  A filter with a double-precision, floating-point value that's been added to a segment query.

  * localized​Name

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

    non-null

    The localized name of the filter.

  * multi​Value

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

    non-null

    Whether a file can have multiple values for a single customer.

  * query​Name

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

    non-null

    The query name of the filter.

* [Segment​Integer​Filter](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentIntegerFilter)

  OBJECT

  A filter with an integer that's been added to a segment query.

  * localized​Name

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

    non-null

    The localized name of the filter.

  * multi​Value

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

    non-null

    Whether a file can have multiple values for a single customer.

  * query​Name

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

    non-null

    The query name of the filter.

* [Segment​String​Filter](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/SegmentStringFilter)

  OBJECT

  A filter with a string that's been added to a segment query.

  * localized​Name

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

    non-null

    The localized name of the filter.

  * multi​Value

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

    non-null

    Whether a file can have multiple values for a single customer.

  * query​Name

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

    non-null

    The query name of the filter.

***

```json
{
	"localizedName": "",
	"multiValue": "",
	"queryName": ""
}
```