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

Requirements

Craft CMS 5.0+
Craft Commerce 5.0+
PHP 8.2+

johnhenry / craft-bundle-builder

Maintainers

Package info

Statistics

Security