--- title: DiscountEffect - GraphQL Admin description: The type of discount that will be applied. Currently, only a percentage discount is supported. api_version: 2025-10 api_name: admin type: union api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/unions/DiscountEffect md: https://shopify.dev/docs/api/admin-graphql/latest/unions/DiscountEffect.md --- # Discount​Effect union Requires Apps must have `read_discounts` access scope. The type of discount that will be applied. Currently, only a percentage discount is supported. ## Possible types * [Discount​Amount](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAmount) OBJECT The fixed amount value of a discount, and whether the amount is applied to each entitled item or spread evenly across the entitled items. * amount [Money​V2!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2) non-null The value of the discount. * applies​On​Each​Item [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null If true, then the discount is applied to each of the entitled items. If false, then the amount is split across all of the entitled items. * [Discount​Percentage](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountPercentage) OBJECT Creates percentage-based discounts that reduce item prices by a specified percentage amount. This gives merchants a flexible way to offer proportional savings that automatically scale with order value. For example, a "20% off all winter clothing" promotion would use this object to apply consistent percentage savings across different price points. Learn more about [discount types](https://help.shopify.com/manual/discounts/). * percentage [Float!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Float) non-null The percentage value of the discount. *** ## Fields with this union * [Discount​On​Quantity.effect](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountOnQuantity#field-DiscountOnQuantity.fields.effect) OBJECT Defines quantity-based discount rules that specify how many items are eligible for a discount effect. This object enables bulk purchase incentives and tiered pricing strategies. For example, a "Buy 4 candles, get 2 candles 50% off (mix and match)" promotion would specify a quantity threshold of 2 items that will receive a percentage discount effect, encouraging customers to purchase more items to unlock savings. The configuration combines quantity requirements with discount effects, allowing merchants to create sophisticated pricing rules that reward larger purchases and increase average order values. *** ```graphql union DiscountEffect = DiscountAmount | DiscountPercentage ```