Bundle BuilderUsing the app
Product add-ons file format
| Column | Description | Example |
|---|---|---|
| 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 import | enabled disabled |
| Offer Name (Required) | Internal name of the offer | offer 1 |
| Component Type (Required) | Identifies if the product should serve a “Trigger” or “Add-on” product in the offer | trigger 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 offer | percent amount_off_each |
| 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 “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 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 discount should be applied if multiple offers match the same trigger conditions. 1 is the highest priority. | 1 |