---
title: DiscountEffect - GraphQL Admin
description: >-
  The type of discount that will be applied. Currently, only a percentage
  discount is supported.
api_version: 2026-10
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'
api_name: admin
api_type: graphql
type: union
---

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

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