Settings
Setting | Type | Default | Description |
Bundle Product | Product picker | — | Bundle to display (required for page/collection templates) |
Show Bundle Title | Checkbox | ✓ | Display bundle title |
Show Bundle Price | Checkbox | ✓ | Display price summary with savings |
Desktop Columns | Range (1-4) | 1 | Product grid columns on desktop |
Mobile Columns | Range (1-3) | 1 | Product grid columns on mobile |
Use Dropdown Variants | Checkbox | ✗ | Force dropdown selectors instead of buttons/swatches |
Expand Multiple Quantities | Checkbox | ✗ | Show separate cards per unit for multi-quantity products |
Show Add to Cart Button | Checkbox | ✗ | Display bundle-specific Add to Cart button |
Cart Action | Select | Drawer | After-add behavior: drawer, redirect, or stay |
Custom Cart Events | Text | — | Comma-separated JS events to dispatch after add to cart |
Show Bundle Items Summary | Checkbox | ✗ | Add selection summary to cart line item |
Theme Swatch Setting | Text | — | Path to theme's swatch config (e.g., |
Custom Swatches | Textarea | — | Custom color mappings, one per line |
Deprecated Settings
These still work but are being replaced by MOD Bundles → Customization:
Setting | Use Instead |
Background Color | Customization → Layout |
Text Color | Customization → Product Card |
Accent Color | Customization → Product Card |
Border Color | Customization → Product Card |
Button Color | Customization → Button |
Button Text Color | Customization → Button |
Border Radius | Customization → Layout |
Troubleshooting
Cart drawer doesn't open
Set Cart Action to "Redirect to cart"
Add your theme's refresh event to Custom Cart Events
Bundle not appearing
Is the Mix & Match block added to the template?
Is the product using the correct template?
Is the product published?
Layout looks wrong on mobile
Reduce Mobile Columns to 1
Check theme container width settings
Swatches not displaying
Option must be named "Color", "Colour", or "Finish"
Check Custom Swatches spelling matches variants
Try adding your theme's swatch setting path