---
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/discount-eligibility-management
  md: https://shopify.dev/changelog/discount-eligibility-management.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

August 18, 2025

Tags:

* Action Required
* Admin GraphQL API
* 2025-10

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

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`.