---
title: DiscountAutomatic - GraphQL Admin
description: >-
  The types of automatic discounts applied in the cart and at checkout when an
  order meets specific criteria.


  Includes
  [`DiscountAutomaticApp`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticApp)
  for custom logic using the [Discount Function

  API](https://shopify.dev/docs/api/functions/latest/discount),
  [`DiscountAutomaticBasic`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticBasic)

  for percentage or fixed amount reductions,
  [`DiscountAutomaticBxgy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticBxgy)

  for Buy X Get Y promotions, and
  [`DiscountAutomaticFreeShipping`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticFreeShipping)

  for delivery incentives.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/unions/DiscountAutomatic'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/unions/DiscountAutomatic.md
api_name: admin
api_type: graphql
type: union
---

# Discount​Automatic

union

Requires Apps must have `read_discounts` access scope.

The types of automatic discounts applied in the cart and at checkout when an order meets specific criteria.

Includes [`DiscountAutomaticApp`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticApp) for custom logic using the [Discount Function API](https://shopify.dev/docs/api/functions/latest/discount), [`DiscountAutomaticBasic`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticBasic) for percentage or fixed amount reductions, [`DiscountAutomaticBxgy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticBxgy) for Buy X Get Y promotions, and [`DiscountAutomaticFreeShipping`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticFreeShipping) for delivery incentives.

## Fields with this union

* [Discount​Automatic​Connection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/DiscountAutomaticConnection#returns-nodes)

  CONNECTION

  An auto-generated type for paginating through multiple DiscountAutomatics.

* [Discount​Automatic​Edge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticEdge#field-DiscountAutomaticEdge.fields.node)

  OBJECT

  An auto-generated type which holds one DiscountAutomatic and a cursor during pagination.

* [Discount​Automatic​Node.automaticDiscount](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticNode#field-DiscountAutomaticNode.fields.automaticDiscount)

  OBJECT

  The `DiscountAutomaticNode` object enables you to manage [automatic discounts](https://help.shopify.com/manual/discounts/discount-types#automatic-discounts) that are applied when an order meets specific criteria. You can create amount off, free shipping, or buy X get Y automatic discounts. For example, you can offer customers a free shipping discount that applies when conditions are met. Or you can offer customers a buy X get Y discount that's automatically applied when customers spend a specified amount of money, or a specified quantity of products.

  Learn more about working with [Shopify's discount model](https://shopify.dev/docs/apps/build/discounts), including related queries, mutations, limitations, and considerations.

***

```graphql
union DiscountAutomatic = DiscountAutomaticApp | DiscountAutomaticBasic | DiscountAutomaticBxgy | DiscountAutomaticFreeShipping
```