Introducing the new context field to specify discount eligibility

As of API version 2025-10, you can use context to specify whether code or automatic 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, 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 and mutations for discount context.