---
title: >-
  Updated function syntax on the segment query language - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/updated-function-syntax-on-the-segment-query-language
  md: >-
    https://shopify.dev/changelog/posts/updated-function-syntax-on-the-segment-query-language.md
metadata:
  effectiveApiVersion: 2026-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2025-03-27T18:07:59-04:00'
  postedAt: '2026-10-01T07:00:00-04:00'
  updatedAt: '2026-09-13T15:24:42-04:00'
  effectiveAt: '2025-07-01T07:00:00-04:00'
---

October 1, 2026

# Updated function syntax on the segment query language

DateOctober 1, 2026

Version[2026-10](https://shopify.dev/changelog?api_version=2026-10)

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

As of GraphQL Admin API version 2026-10, functions in the segment query language now use the operators `MATCHES`/`NOT MATCHES` instead of `= true`/`= false`. For example, the previous query `shopify_email.opened() = true` would now be represented as `shopify_email.opened MATCHES ()`.

The parameters for each function have also been expanded to use their own operators. For example, the query `products_purchased(quantity: 5) = true` would now be represented as `products_purchased MATCHES (quantity = 5)`. This expands the functionality of parameters. For example, the following queries were not possible before: `products_purchased MATCHES (quantity != 5)`, `products_purchased MATCHES (quantity > 5)`.

Additionally, the following [named dates](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference#nameddate) have been deprecated: `12_months_ago`, `90_days_ago`, `30_days_ago`, `7_days_ago`. Instead, the you can use the existing [date offsets](https://shopify.dev/docs/api/shopifyql/segment-query-language-reference#dateoffset) in your segment queries. For example, the named date `12_months_ago` is equivalent to the date offset `-12m`.

Learn more about customer segment filters in our [Help Center](https://help.shopify.com/en/manual/customers/customer-segmentation/reference-guide/components).