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:
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).
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.
privateMetafield:
PrivateMetafield -
Returns a private metafield by namespace and key that belongs to the resource.
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
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
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
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.
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
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
Types of resources that may use metafields to reference other resources.