# 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