# DiscountCodeBxgy - admin-graphql - OBJECT Version: 2025-01 ## Description The `DiscountCodeBxgy` object lets you manage [buy X get Y discounts (BXGY)](https://help.shopify.com/manual/discounts/discount-types/buy-x-get-y) that are applied on a cart and at checkout when a customer enters a code. 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 `DiscountCodeBxgy` object stores information about BXGY code 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 [`DiscountAutomaticBxgy`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DiscountAutomaticBxgy) object has similar functionality to the `DiscountCodeBxgy` object, but discounts are automatically applied, without the need for customers to enter a code. ### Access Scopes Apps must have `read_discounts` access scope. ## Fields * [appliesOncePerCustomer](/docs/api/admin-graphql/2025-01/scalars/Boolean): Boolean! - Whether a customer can only use the discount once. * [asyncUsageCount](/docs/api/admin-graphql/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. * [codesCount](/docs/api/admin-graphql/2025-01/objects/Count): Count - The number of codes that a customer can use to redeem the discount. * [combinesWith](/docs/api/admin-graphql/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-graphql/2025-01/scalars/DateTime): DateTime! - The date and time when the discount was created. * [customerBuys](/docs/api/admin-graphql/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-graphql/2025-01/objects/DiscountCustomerGets): DiscountCustomerGets! - The items in the order that qualify for the discount, their quantities, and the total value of the discount. * [customerSelection](/docs/api/admin-graphql/2025-01/unions/DiscountCustomerSelection): DiscountCustomerSelection! - The customers that can use the discount. * [discountClass](/docs/api/admin-graphql/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-graphql/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`. * [hasTimelineComment](/docs/api/admin-graphql/2025-01/scalars/Boolean): Boolean! - Whether there are [timeline comments](https://help.shopify.com/manual/discounts/managing-discount-codes#use-the-discount-timeline) associated with the discount. * [shareableUrls](/docs/api/admin-graphql/2025-01/objects/DiscountShareableUrl): DiscountShareableUrl! - A list of URLs that the app can use to share the discount. * [startsAt](/docs/api/admin-graphql/2025-01/scalars/DateTime): DateTime! - The date and time when the discount becomes active and is available to customers. * [status](/docs/api/admin-graphql/2025-01/enums/DiscountStatus): DiscountStatus! - The status of the discount that describes its availability, expiration, or pending activation. * [summary](/docs/api/admin-graphql/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-graphql/2025-01/scalars/String): String! - The discount's name that displays to merchants in the Shopify admin and to customers. * [totalSales](/docs/api/admin-graphql/2025-01/objects/MoneyV2): MoneyV2 - The total sales from orders where the discount was used. * [updatedAt](/docs/api/admin-graphql/2025-01/scalars/DateTime): DateTime! - The date and time when the discount was updated. * [usageLimit](/docs/api/admin-graphql/2025-01/scalars/Int): Int - The maximum number of times that a customer can use the discount. For discounts with unlimited usage, specify `null`. * [usesPerOrderLimit](/docs/api/admin-graphql/2025-01/scalars/Int): Int - The maximum number of times that the discount can be applied to an order. ## Connections * [codes](/docs/api/admin-graphql/2025-01/connections/DiscountRedeemCodeConnection): DiscountRedeemCodeConnection! ## Related queries ## Related mutations ## Related Unions * [Discount](/docs/api/admin-graphql/2025-01/unions/Discount) A discount. * [DiscountCode](/docs/api/admin-graphql/2025-01/unions/DiscountCode) The type of discount associated with the discount code. For example, the discount code might offer a basic discount of a fixed percentage, or a fixed amount, on specific products or the order. Alternatively, the discount might offer the customer free shipping on their order. A third option is a Buy X, Get Y (BXGY) discount, which offers a customer discounts on select products if they add a specific product to their order. ## Examples