Bundle BuilderUsing the app
Buy X get Y offer file format
| Column | Description | Example |
|---|---|---|
| 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 import | enabled disabled |
| Offer Name (Required) | Internal name of the offer | offer 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 displayed | red-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 discount | 3 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 dates | 2025-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 dates | 2025-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 |