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

# Subscription​Discount

object

Requires the `read_own_subscription_contracts` or `write_own_subscription_contracts` scope.

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.

  * after

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

    ### Arguments

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * before

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

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * first

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

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * last

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

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

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

    Default:false

    Reverse the order of the underlying list.

  ***

* 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)