---
title: SubscriptionDiscountValue - Customer API
description: The value of the discount and how it will be applied.
api_version: 2025-10
api_name: customer
type: union
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/customer/latest/unions/SubscriptionDiscountValue
  md: >-
    https://shopify.dev/docs/api/customer/latest/unions/SubscriptionDiscountValue.md
---

# Subscription​Discount​Value

union

The value of the discount and how it will be applied.

## Possible types

* [Subscription​Discount​Fixed​Amount​Value](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionDiscountFixedAmountValue)

  OBJECT

  The value of the discount and how it will be applied.

  * amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The fixed amount value of the discount.

  * applies​On​Each​Item

    [Boolean!](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

    non-null

    Whether the amount is applied per item.

* [Subscription​Discount​Percentage​Value](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionDiscountPercentageValue)

  OBJECT

  The percentage value of the discount.

  * percentage

    [Int!](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    non-null

    The percentage value of the discount.

***

## Fields with this union

* [Subscription​Discount.value](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionDiscount#field-SubscriptionDiscount.fields.value)

  OBJECT

  A discount applied to a subscription contract.

***

```graphql
union SubscriptionDiscountValue = SubscriptionDiscountFixedAmountValue | SubscriptionDiscountPercentageValue
```