README

Bundle Builder for Craft Commerce

Product bundles for Craft Commerce 5. A bundle is a first-class purchasable element that groups several products together and sells as a single line item, with flexible pricing, cart-time variant selection, component inventory tracking, and mixed-supply tax handling that works with whatever tax scheme (VAT, GST, sales tax) you've set up in Commerce.

Features

• Bundle elements edited through Craft's native element editor (live preview, drafts, revisions, autosave).
• Bundle types with their own field layout, SKU/description formats, per-site URL settings, preview targets, and tax treatment.
• Pricing
  • Fixed: a set price (plus optional promotional price).
  • Automatic: the summed price of the components (each component's own sale or catalog-pricing-rule price, when one applies), less a percentage or flat discount. Recalculated automatically when a component product's price changes.
• Cart-time variant selection: the customer chooses a variant for each component; the bundle stays one line item, with the choices stored as readable line-item options and a frozen snapshot.
• Availability gated by the post/expiry window and by each component having an in-stock variant.
• Inventory: on order completion, each chosen component variant's stock is decremented (the bundle itself doesn't track inventory).
• Tax treatment (composite vs multiple supply, set per bundle type)
  • Composite supply: the whole bundle is taxed at the bundle's own tax category (principal element rate).
  • Multiple supply: the price is apportioned across components and each is taxed at its own product's tax category rate, for any tax scheme configured in Commerce.
• Twig API via craft.bundleBuilder.

Documentation

Full documentation is at https://johnhenry.ie/plugins/bundle-builder/

Support

Need a hand? Head over to the GitHub Issues page

License

Proprietary - Copyright (c) 2026 John Henry Donovan

Requirements

• Craft CMS 5.0+
• Craft Commerce 5.0+
• PHP 8.2+