# DiscountAutomaticBxgy - admin - OBJECT
Version: 2025-01

## Description
The `DiscountAutomaticBxgy` object lets you manage
[buy X get Y discounts (BXGY)](https://help.shopify.com/manual/discounts/discount-types/buy-x-get-y)
that are automatically applied on a cart and at checkout. BXGY discounts incentivize customers by offering
them additional items at a discounted price or for free when they purchase a specified quantity of items.

The `DiscountAutomaticBxgy` object stores information about automatic BXGY 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 [`DiscountCodeBxgy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountCodeBxgy)
object has similar functionality to the `DiscountAutomaticBxgy` object, but customers need to enter a code to
receive a discount.

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


## Fields
* [asyncUsageCount](/docs/api/admin/2025-01/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/2025-01/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/2025-01/scalars/DateTime): DateTime! - The date and time when the discount was created.
* [customerBuys](/docs/api/admin/2025-01/objects/DiscountCustomerBuys): DiscountCustomerBuys! - The items eligible for the discount and the required quantity of each to receive the discount.
* [customerGets](/docs/api/admin/2025-01/objects/DiscountCustomerGets): DiscountCustomerGets! - The items in the order that qualify for the discount, their quantities, and the total value of the discount.
* [discountClass](/docs/api/admin/2025-01/enums/MerchandiseDiscountClass): MerchandiseDiscountClass! - 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/2025-01/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`.
* [id](/docs/api/admin/2025-01/scalars/ID): ID! - A legacy unique ID for the discount.
* [startsAt](/docs/api/admin/2025-01/scalars/DateTime): DateTime! - The date and time when the discount becomes active and is available to customers.
* [status](/docs/api/admin/2025-01/enums/DiscountStatus): DiscountStatus! - The status of the discount that describes its availability,
expiration, or pending activation.
* [summary](/docs/api/admin/2025-01/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/2025-01/scalars/String): String! - The discount's name that displays to merchants in the Shopify admin and to customers.
* [updatedAt](/docs/api/admin/2025-01/scalars/DateTime): DateTime! - The date and time when the discount was updated.
* [usageCount](/docs/api/admin/2025-01/scalars/Int): Int! - The number of times that the discount has been used.
* [usesPerOrderLimit](/docs/api/admin/2025-01/scalars/Int): Int - The maximum number of times that the discount can be applied to an order.

## Connections
* [events](/docs/api/admin/2025-01/connections/EventConnection): EventConnection!



## Related queries

## Related mutations

## Related Unions
* [Discount](/docs/api/admin/2025-01/unions/Discount) A discount.
* [DiscountAutomatic](/docs/api/admin/2025-01/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