Skip to content

Bundle BuilderUsing the app

Bundle offer file format

ColumnDescriptionExample
Offer type (Required)This column stores the current offer’s type.bundle
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
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 of Bundle Products (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 bundle offer.1
10
100
Display On (Required)Choose the products where you want to show to the bundle 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:
- percent - a percentage discount
- fixed - a fixed discount
percent
fixed
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 “Bundle” widget on the storefront.Frequently bought together
Widget Description (optional)A text appeared below a title of the “Bundle” 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 bundle discount should be applied if multiple bundle offers match the same trigger conditions. 1 is the highest priority.1