# DiscountCodeFreeShippingInput - admin-graphql - INPUT_OBJECT
Version: 2024-10

## Description
The input fields for creating or updating a [free shipping discount](https://help.shopify.com/manual/discounts/discount-types/free-shipping) that's applied on a cart and at checkout when a customer enters a code.

### Access Scopes



## Fields
* [appliesOnOneTimePurchase](/docs/api/admin-graphql/2024-10/scalars/Boolean): Boolean - Whether the discount applies on one-time purchases. A one-time purchase is a transaction where you pay a single time for a product, without any ongoing commitments or recurring charges.
* [appliesOnSubscription](/docs/api/admin-graphql/2024-10/scalars/Boolean): 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.
* [appliesOncePerCustomer](/docs/api/admin-graphql/2024-10/scalars/Boolean): Boolean - Whether a customer can only use the discount once.
* [code](/docs/api/admin-graphql/2024-10/scalars/String): String - The code that customers use to apply the discount.
* [combinesWith](/docs/api/admin-graphql/2024-10/input-objects/DiscountCombinesWithInput): DiscountCombinesWithInput - The
[discount classes](https://help.shopify.com/manual/discounts/combining-discounts/discount-combinations)
that you can use in combination with the shipping discount.
* [customerSelection](/docs/api/admin-graphql/2024-10/input-objects/DiscountCustomerSelectionInput): DiscountCustomerSelectionInput - The customers that can use the discount. You can target specific customer IDs or make the discount available to all customers.
* [destination](/docs/api/admin-graphql/2024-10/input-objects/DiscountShippingDestinationSelectionInput): DiscountShippingDestinationSelectionInput - The shipping destinations where the free shipping discount can be applied. You can specify whether the discount applies to all countries, or specify individual countries.
* [endsAt](/docs/api/admin-graphql/2024-10/scalars/DateTime): 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](/docs/api/admin-graphql/2024-10/scalars/Decimal): Decimal - The maximum shipping price, in the shop's currency, that qualifies for free shipping.
<br/><br/>
For example, if set to 20.00, then only shipping rates that cost $20.00 or less will be made free. To apply the discount to all shipping rates, specify `null`.
* [minimumRequirement](/docs/api/admin-graphql/2024-10/input-objects/DiscountMinimumRequirementInput): DiscountMinimumRequirementInput - The minimum subtotal or quantity of items that are required for the discount to be applied.
* [recurringCycleLimit](/docs/api/admin-graphql/2024-10/scalars/Int): Int - The number of billing cycles for which the discount can be applied, which is useful for subscription-based discounts.
<br/><br/>
For example, if set to `3`, then the discount only applies to the first three billing cycles of a subscription. If set to `0`, then the discount applies indefinitely.
* [startsAt](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime - The date and time when the discount becomes active and is available to customers.
* [title](/docs/api/admin-graphql/2024-10/scalars/String): String - The discount's name that displays to merchants in the Shopify admin and to customers.
* [usageLimit](/docs/api/admin-graphql/2024-10/scalars/Int): Int - The maximum number of times that a customer can use the discount.
For discounts with unlimited usage, specify `null`.


## Input objects with this input object
* [discountCodeFreeShippingCreate](/docs/api/admin-graphql/2024-10/mutations/discountCodeFreeShippingCreate)
* [discountCodeFreeShippingUpdate](/docs/api/admin-graphql/2024-10/mutations/discountCodeFreeShippingUpdate)


## Examples