Skip to content

Bundle BuilderUsing the app

Buy X get Y offer file format

ColumnDescriptionExample
Offer type (Required)This column stores the current offer’s type.bxgy
Offer ID (Required)This field is used to uniquely identify each bundle offer you are importing. It serves as a way for the system to recognize which lines belong to the same offer.
It can be any value you choose, as long as it is unique for each offer.

When creating new offers:

◦ Use a custom alphanumeric ID (e.g., BUNDLE123, OFFER_A1).
◦ The ID must contain at least one letter. Numeric-only IDs like 123 are not valid.
◦ All rows that belong to the same offer must share the same Offer ID.

When updating existing offers via export:

◦ You’ll notice existing Offer IDs appear as numbers (e.g., 2415).
◦ Do not change these numeric Offer IDs — the app uses them to match and update the correct offers.
◦ If a line has a new alphanumeric ID, the app will treat it as a new offer.
offer123
OFFER_A1
Offer Status (Required if enabled”)Identifies if the offer should be active or deactivated after the importenabled
disabled
Offer Name (Required)Internal name of the offeroffer 1
Purchase Type (Required)This field is used to define the role of each product in a Buy X Get Y offer.

Products marked as “X” are the ones that a customer must buy to qualify for the offer.

Products marked as “Y” are the ones the customer can get at a discount or for free as part of the promotion.

Your file must contain at least one row for each type — X and Y — to form a valid Buy X Get Y offer.
X
Y
Products Handle (Required)A product handle is a short name used by Shopify to identify a specific product. It helps the system recognize which product you’re referring to.

For example:
If the URL of your product page is
https://yourstore.com/products/red-sneakers
then the product handle is: red-sneakers
red-sneakers
Variants (Required)Handles of variants of a product.
- If you want to add all variants of a product, add “All”.
- If you want to add certain variants of a product, list the handles of these variants separated by the comma (w/o spaces).
- If varainst are compound (for example, Size/Color), use slash “/” as a divider, with spaces before and after /
All

S,M,L,XL

M / Black,M / White,L / Black,L / White
Quantity (Required)The quantity of each product in the Buy X Get Y offer.1
10
100
Display On (Required)Choose the products where you want to show to the Buy X Get Y offer on:
- Products in offer
- Specific products
offer_products
specific_products
Display On Products (Required if the “Display On” is “specific_products”)Insert the Product handles of the products the offer should be displayedred-sneakers
Discount Type (optional)A discount type you want to enable for the offer:
- Percentage
- Amount off each
- Free
percent
amount_off_each
free
Discount Value (Required if a “Discount Type” is added)A numeric value of a discount3
5.12
12.0
Discount Code (Required if a “Discount Type” is added)A discount code, which will be used as the automatic discount code applied on the storefront.discount 1
Widget Title (optional)A title of the “Buy X Get Y” widget on the storefront.Get More for Less!
Widget Description (optional)A text appeared below a title of the “Buy X Get Y” widget on the storefront.
Start Date (optional)Set the start date, if you want to enable this offer for certain dates2025-01-13 15:00:00

2024-08-22T13:22:07+00:00
End Date (optional)Set the end date, if you want to enable this offer for certain dates2025-01-13 15:00:00

2024-08-22T13:22:07+00:00
Priority (optional)This setting defines what offer discount should be applied if multiple offers match the same trigger conditions. 1 is the highest priority.1