The input fields for creating or updating a
[free shipping discount](https://help.shopify.com/manual/discounts/discount-types/free-shipping)
that's automatically applied on a cart and at checkout.
Access Scopes
Fields
appliesOnOneTimePurchase:
Boolean -
Whether the discount applies on regular one-time-purchase items.
appliesOnSubscription:
Boolean -
Whether the discount applies on subscription items.
[Subscriptions](https://shopify.dev/docs/apps/launch/billing/subscription-billing/offer-subscription-discounts)
enable customers to purchase products
on a recurring basis.
combinesWith:
DiscountCombinesWithInput -
The
[discount classes](https://help.shopify.com/manual/discounts/combining-discounts/discount-combinations)
that you can use in combination with the shipping discount.
destination:
DiscountShippingDestinationSelectionInput -
A list of destinations where the discount will apply.
endsAt:
DateTime -
The date and time when the discount expires and is no longer available to customers.
For discounts without a fixed expiration date, specify `null`.
maximumShippingPrice:
Decimal -
The maximum shipping price that qualifies for the discount.
minimumRequirement:
DiscountMinimumRequirementInput -
The minimum subtotal or quantity of items that are required for the discount to be applied.
recurringCycleLimit:
Int -
The number of billing cycles for which the discount can be applied,
which is useful for subscription-based discounts. For example, if you set this field
to `3`, then the discount only applies to the first three billing cycles of a
subscription. If you specify `0`, then the discount applies indefinitely.
startsAt:
DateTime -
The date and time when the discount becomes active and is available to customers.
title:
String -
The discount's name that displays to merchants in the Shopify admin and to customers.