# DiscountAutomaticFreeShipping - admin-graphql - OBJECT Version: 2024-10 ## Description The `DiscountAutomaticFreeShipping` object lets you manage [free shipping discounts](https://help.shopify.com/manual/discounts/discount-types/free-shipping) that are automatically applied on a cart and at checkout. Free shipping discounts are promotional deals that merchants offer to customers to waive shipping costs and encourage online purchases. The `DiscountAutomaticFreeShipping` object stores information about automatic free shipping discounts that apply to specific [products and variants](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountProducts), [collections](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCollections), or [all items in a cart](https://shopify.dev/docs/api/admin-graphql/latest/objects/AllDiscountItems). Learn more about working with [Shopify's discount model](https://shopify.dev/docs/apps/build/discounts), including limitations and considerations. > Note: > The [`DiscountCodeFreeShipping`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCodeFreeShipping) object has similar functionality to the `DiscountAutomaticFreeShipping` object, but customers need to enter a code to receive a discount. ### Access Scopes Apps must have `read_discounts` access scope. ## 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. * [asyncUsageCount](/docs/api/admin-graphql/2024-10/scalars/Int): Int! - The number of times that the discount has been used. For example, if a "Buy 3, Get 1 Free" t-shirt discount is automatically applied in 200 transactions, then the discount has been used 200 times. This value is updated asynchronously. As a result, it might be lower than the actual usage count until the asynchronous process is completed. * [combinesWith](/docs/api/admin-graphql/2024-10/objects/DiscountCombinesWith): DiscountCombinesWith! - The [discount classes](https://help.shopify.com/manual/discounts/combining-discounts/discount-combinations) that you can use in combination with [Shopify discount types](https://help.shopify.com/manual/discounts/discount-types). * [createdAt](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime! - The date and time when the discount was created. * [destinationSelection](/docs/api/admin-graphql/2024-10/unions/DiscountShippingDestinationSelection): DiscountShippingDestinationSelection! - The countries that qualify for the discount. You can define [a list of countries](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCountries) or specify [all countries](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCountryAll) to be eligible for the discount. * [discountClass](/docs/api/admin-graphql/2024-10/enums/ShippingDiscountClass): ShippingDiscountClass! - The [discount class](https://help.shopify.com/manual/discounts/combining-discounts/discount-combinations) that's used to control how discounts can be combined. * [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`. * [hasTimelineComment](/docs/api/admin-graphql/2024-10/scalars/Boolean): Boolean! - Whether there are [timeline comments](https://help.shopify.com/manual/discounts/managing-discount-codes#use-the-discount-timeline) associated with the discount. * [maximumShippingPrice](/docs/api/admin-graphql/2024-10/objects/MoneyV2): MoneyV2 - The maximum shipping price amount accepted to qualify for the discount. * [minimumRequirement](/docs/api/admin-graphql/2024-10/unions/DiscountMinimumRequirement): DiscountMinimumRequirement! - 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. 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. * [shortSummary](/docs/api/admin-graphql/2024-10/scalars/String): String! - An abbreviated version of the discount [`summary`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticFreeShipping#field-summary) field. * [startsAt](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime! - The date and time when the discount becomes active and is available to customers. * [status](/docs/api/admin-graphql/2024-10/enums/DiscountStatus): DiscountStatus! - The status of the discount that describes its availability, expiration, or pending activation. * [summary](/docs/api/admin-graphql/2024-10/scalars/String): String! - A detailed explanation of what the discount is, who can use it, when and where it applies, and any associated rules or limitations. * [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. * [totalSales](/docs/api/admin-graphql/2024-10/objects/MoneyV2): MoneyV2 - The total sales from orders where the discount was used. * [updatedAt](/docs/api/admin-graphql/2024-10/scalars/DateTime): DateTime! - The date and time when the discount was updated. ## Connections ## Related queries ## Related mutations ## Related Unions * [Discount](/docs/api/admin-graphql/2024-10/unions/Discount) A discount. * [DiscountAutomatic](/docs/api/admin-graphql/2024-10/unions/DiscountAutomatic) The type of discount associated to the automatic discount. For example, the automatic discount might offer a basic discount using a fixed percentage, or a fixed amount, on specific products from the order. The automatic discount may also be a BXGY discount, which offers customer discounts on select products if they add a specific product to their order. ## Examples