---
title: DiscountAutomaticFreeShippingInput - GraphQL Admin
description: >-
  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.
api_version: 2025-01
api_name: admin
type: input-object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/DiscountAutomaticFreeShippingInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/DiscountAutomaticFreeShippingInput.md
---

# Discount​Automatic​Free​Shipping​Input

input\_object

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.

## Fields

* applies​On​One​Time​Purchase

  [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Boolean)

  Default:true

  Whether the discount applies on regular one-time-purchase items.

* applies​On​Subscription

  [Boolean](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Boolean)

  Default:false

  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.

* combines​With

  [Discount​Combines​With​Input](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/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

  [Discount​Shipping​Destination​Selection​Input](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/DiscountShippingDestinationSelectionInput)

  A list of destinations where the discount will apply.

* ends​At

  [Date​Time](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/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`.

* maximum​Shipping​Price

  [Decimal](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/Decimal)

  The maximum shipping price that qualifies for the discount.

* minimum​Requirement

  [Discount​Minimum​Requirement​Input](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/DiscountMinimumRequirementInput)

  The minimum subtotal or quantity of items that are required for the discount to be applied.

* recurring​Cycle​Limit

  [Int](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/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.

* starts​At

  [Date​Time](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/DateTime)

  The date and time when the discount becomes active and is available to customers.

* title

  [String](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String)

  The discount's name that displays to merchants in the Shopify admin and to customers.

***

## Map

No referencing types