# DiscountAutomaticNode - admin-graphql - OBJECT
Version: 2025-01

## Description
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.

### Access Scopes
Apps must have `read_discounts` access scope.


## Fields
* [automaticDiscount](/docs/api/admin-graphql/2025-01/unions/DiscountAutomatic): DiscountAutomatic! - A discount that's applied automatically when an order meets specific criteria. Learn more about [automatic discounts](https://help.shopify.com/manual/discounts/discount-types#automatic-discounts).
* [id](/docs/api/admin-graphql/2025-01/scalars/ID): ID! - A globally-unique ID.
* [metafield](/docs/api/admin-graphql/2025-01/objects/Metafield): Metafield - A [custom field](https://shopify.dev/docs/apps/build/custom-data),
including its `namespace` and `key`, that's associated with a Shopify resource
for the purposes of adding and storing additional information.

## Connections
* [events](/docs/api/admin-graphql/2025-01/connections/EventConnection): EventConnection!
* [metafieldDefinitions](/docs/api/admin-graphql/2025-01/connections/MetafieldDefinitionConnection): MetafieldDefinitionConnection!
* [metafields](/docs/api/admin-graphql/2025-01/connections/MetafieldConnection): MetafieldConnection!



## Related queries
* [automaticDiscountNode](/docs/api/admin-graphql/2025-01/queries/automaticDiscountNode) Returns an automatic discount resource by ID.
* [automaticDiscountNodes](/docs/api/admin-graphql/2025-01/queries/automaticDiscountNodes) Returns a list of [automatic discounts](https://help.shopify.com/manual/discounts/discount-types#automatic-discounts).

## Related mutations
* [discountAutomaticActivate](/docs/api/admin-graphql/2025-01/mutations/discountAutomaticActivate) Activates an automatic discount.
* [discountAutomaticBasicCreate](/docs/api/admin-graphql/2025-01/mutations/discountAutomaticBasicCreate) Creates an
[amount off discount](https://help.shopify.com/manual/discounts/discount-types/percentage-fixed-amount)
that's automatically applied on a cart and at checkout.

> Note:
> To create code discounts, use the
[`discountCodeBasicCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeBasicCreate)
mutation.
* [discountAutomaticBasicUpdate](/docs/api/admin-graphql/2025-01/mutations/discountAutomaticBasicUpdate) Updates an existing
[amount off discount](https://help.shopify.com/manual/discounts/discount-types/percentage-fixed-amount)
that's automatically applied on a cart and at checkout.

> Note:
> To update code discounts, use the
[`discountCodeBasicUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeBasicUpdate)
mutation instead.
* [discountAutomaticBxgyCreate](/docs/api/admin-graphql/2025-01/mutations/discountAutomaticBxgyCreate) Creates a
[buy X get Y discount (BXGY)](https://help.shopify.com/manual/discounts/discount-types/buy-x-get-y)
that's automatically applied on a cart and at checkout.

> Note:
> To create code discounts, use the
[`discountCodeBxgyCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeBxgyCreate)
mutation.
* [discountAutomaticBxgyUpdate](/docs/api/admin-graphql/2025-01/mutations/discountAutomaticBxgyUpdate) Updates an existing
[buy X get Y discount (BXGY)](https://help.shopify.com/manual/discounts/discount-types/buy-x-get-y)
that's automatically applied on a cart and at checkout.

> Note:
> To update code discounts, use the
[`discountCodeBxgyUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeBxgyUpdate)
mutation instead.
* [discountAutomaticDeactivate](/docs/api/admin-graphql/2025-01/mutations/discountAutomaticDeactivate) Deactivates an automatic discount.
* [discountAutomaticFreeShippingCreate](/docs/api/admin-graphql/2025-01/mutations/discountAutomaticFreeShippingCreate) Creates a
[free shipping discount](https://help.shopify.com/manual/discounts/discount-types/free-shipping)
that's automatically applied on a cart and at checkout.

> Note:
> To create code discounts, use the
[`discountCodeFreeShippingCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeFreeShippingCreate)
mutation.
* [discountAutomaticFreeShippingUpdate](/docs/api/admin-graphql/2025-01/mutations/discountAutomaticFreeShippingUpdate) Updates an existing
[free shipping discount](https://help.shopify.com/manual/discounts/discount-types/free-shipping)
that's automatically applied on a cart and at checkout.

> Note:
> To update code discounts, use the
[`discountCodeFreeShippingUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/discountCodeFreeShippingUpdate)
mutation instead.

## Related Unions
* [MetafieldReferencer](/docs/api/admin-graphql/2025-01/unions/MetafieldReferencer) Types of resources that may use metafields to reference other resources.

## Examples