---
title: SubscriptionDiscount - Customer API
description: A discount applied to a subscription contract.
api_version: 2025-10
api_name: customer
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/objects/subscriptiondiscount
  md: https://shopify.dev/docs/api/customer/latest/objects/subscriptiondiscount.md
---

# Subscription​Discount

object

A discount applied to a subscription contract.

## Fields

* applies​To​All​Lines

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

  non-null

  Specify whether the subscription discount will apply on all subscription lines.

* id

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

  non-null

  The unique ID.

* lines

  [Subscription​Line​Connection](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionLineConnection)

  The list of subscription lines associated with the subscription discount.

* recurring​Cycle​Limit

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

  The maximum number of times the subscription discount will be applied on orders.

* target​Type

  [Discount​Target​Type!](https://shopify.dev/docs/api/customer/latest/enums/DiscountTargetType)

  non-null

  Type of line the discount applies on.

* title

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

  The title associated with the subscription discount.

* type

  [Discount​Type!](https://shopify.dev/docs/api/customer/latest/enums/DiscountType)

  non-null

  The type of the subscription discount.

* usage​Count

  [Count](https://shopify.dev/docs/api/customer/latest/objects/Count)

  The number of times the discount was applied.

* value

  [Subscription​Discount​Value!](https://shopify.dev/docs/api/customer/latest/unions/SubscriptionDiscountValue)

  non-null

  The value of the subscription discount.

***

## Map

### Fields and connections with this object

* {}[SubscriptionContract.discounts](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionContract#field-SubscriptionContract.fields.discounts)
* ||-[SubscriptionContractBase.discounts](https://shopify.dev/docs/api/customer/latest/interfaces/SubscriptionContractBase#fields-discounts)
* {}[SubscriptionDiscountAllocation.discount](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionDiscountAllocation#field-SubscriptionDiscountAllocation.fields.discount)
* <->[SubscriptionDiscountConnection.nodes](https://shopify.dev/docs/api/customer/latest/connections/SubscriptionDiscountConnection#returns-nodes)
* {}[SubscriptionDiscountEdge.node](https://shopify.dev/docs/api/customer/latest/objects/SubscriptionDiscountEdge#field-SubscriptionDiscountEdge.fields.node)