---
title: >-
  Introducing the new context field to specify discount eligibility - 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/discount-eligibility-management'
  md: 'https://shopify.dev/changelog/posts/discount-eligibility-management.md'
metadata:
  effectiveApiVersion: 2025-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: true
  createdAt: '2025-01-28T16:54:01-05:00'
  postedAt: '2025-08-18T16:20:00-04:00'
  updatedAt: '2025-08-18T16:06:50-04:00'
  effectiveAt: '2025-02-28T12:00:00-05:00'
---

August 18, 2025

# Introducing the new `context` field to specify discount eligibility

DateAugust 18, 2025

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

FlagsNew[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 API version 2025-10, you can use `context` to specify whether [code](https://help.shopify.com/en/manual/discounts/discount-methods/discount-codes) or [automatic](https://help.shopify.com/en/manual/discounts/discount-methods/automatic-discounts) discounts are eligible for all customers, specific customers, or customer segments.

Specifying customer eligibility is a new feature for automatic discounts. For code discounts, `context` replaces [`customerSelection`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/DiscountCustomerSelectionInput), which is now marked as deprecated and will be removed in a future version.

API versions older than 2025-10 do not support customer eligibility for automatic discounts. Automatic discounts with customer or customer segment eligibility applied will be filtered out from queries prior to 2025-10.

Learn more about objects used in [queries](https://shopify.dev/docs/api/admin-graphql/2025-10/unions/DiscountContext) and [mutations](https://shopify.dev/docs/api/admin-graphql/2025-10/input-objects/DiscountContextInput) for discount `context`.