--- title: SubscriptionManualDiscount - GraphQL Admin description: Custom subscription discount. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionManualDiscount md: https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionManualDiscount.md --- # Subscription​Manual​Discount object Requires the `read_own_subscription_contracts` or `write_own_subscription_contracts` scope. Custom subscription discount. ## Fields * entitled​Lines [Subscription​Discount​Entitled​Lines!](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDiscountEntitledLines) non-null Entitled line items used to apply the subscription discount on. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null The unique ID. * recurring​Cycle​Limit [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int) The maximum number of times the subscription discount will be applied on orders. * rejection​Reason [Subscription​Discount​Rejection​Reason](https://shopify.dev/docs/api/admin-graphql/latest/enums/SubscriptionDiscountRejectionReason) The reason that the discount on the subscription draft is rejected. * target​Type [Discount​Target​Type!](https://shopify.dev/docs/api/admin-graphql/latest/enums/DiscountTargetType) non-null Type of line the discount applies on. * title [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The title associated with the subscription discount. * type [Discount​Type!](https://shopify.dev/docs/api/admin-graphql/latest/enums/DiscountType) non-null The type of the subscription discount. * usage​Count [Int!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int) non-null The number of times the discount was applied. * value [Subscription​Discount​Value!](https://shopify.dev/docs/api/admin-graphql/latest/unions/SubscriptionDiscountValue) non-null The value of the subscription discount. *** ## Map ### Fields and connections with this object * {}[SubscriptionBillingCycleEditedContract.discounts](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionBillingCycleEditedContract#field-SubscriptionBillingCycleEditedContract.fields.discounts) * {}[SubscriptionContract.discounts](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionContract#field-SubscriptionContract.fields.discounts) * ||-[SubscriptionContractBase.discounts](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/SubscriptionContractBase#fields-discounts) * <->[SubscriptionManualDiscountConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/SubscriptionManualDiscountConnection#returns-nodes) * {}[SubscriptionManualDiscountEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionManualDiscountEdge#field-SubscriptionManualDiscountEdge.fields.node) ### Possible type in * [Subscription​Discount](https://shopify.dev/docs/api/admin-graphql/latest/unions/SubscriptionDiscount) *** ## Mutations * [subscription​Draft​Discount​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftDiscountAdd) mutation Adds a subscription discount to a subscription draft. * [subscription​Draft​Discount​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftDiscountUpdate) mutation Updates a subscription discount on a subscription draft. * [subscription​Draft​Free​Shipping​Discount​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftFreeShippingDiscountAdd) mutation Adds a subscription free shipping discount to a subscription draft. * [subscription​Draft​Free​Shipping​Discount​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftFreeShippingDiscountUpdate) mutation Updates a subscription free shipping discount on a subscription draft. * [subscription​Draft​Line​Remove](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftLineRemove) mutation Removes a subscription line from a subscription draft. *** ## <\~> SubscriptionManualDiscount Mutations ### Mutated by * <\~>[subscription​Draft​Discount​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftDiscountAdd) * <\~>[subscription​Draft​Discount​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftDiscountUpdate) * <\~>[subscription​Draft​Free​Shipping​Discount​Add](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftFreeShippingDiscountAdd) * <\~>[subscription​Draft​Free​Shipping​Discount​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftFreeShippingDiscountUpdate) * <\~>[subscription​Draft​Line​Remove](https://shopify.dev/docs/api/admin-graphql/latest/mutations/subscriptionDraftLineRemove)