Skip to content

Bundle BuilderUsing the app

Product add-ons file format

ColumnDescriptionExample
Offer type (Required)This column stores the current offer’s type.addons
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
Component Type (Required)Identifies if the product should serve a “Trigger” or “Add-on” product in the offertrigger
add-on
Content Type (Required)This field is used to identify if the trigger product(s) are selected by product or by collection.product
collection
Products Handle (Required if the “Component Type” - “product”)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 Products (Required if the “Component Type” - “product”)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
Collection Handle (Required if the “Component Type” - “collection”)A collection handle is a short name used by Shopify to identify a specific collection. It helps the system know which collection you’re referring to.

For example:
If the URL of your collection page is
https://yourstore.com/collections/summer-sale
then the collection handle is: summer-sale
summer-sale
Min Quantity (Required)The minimal quantity of a product in the offer.
For the “Fixed” offers, the Min and Max Quantity should be equal.
0
10
100
Max Quantity (Required)The maximal quantity of a product in the offer.
For the “Fixed” offers, the Min and Max Quantity should be equal.
Max QTY limit cannot be 0.
10
100
Discount Type (Optional)A discount type you want to enable for the offerpercent
amount_off_each
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 “Product add-ons” widget on the storefront.Recommended products
Widget Description (optional)A text appeared below a title of the “Product add-ons” 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 discount should be applied if multiple offers match the same trigger conditions. 1 is the highest priority.1