Overview
This page explains the handful of concepts the whole plugin is built on. Once these are clear, every setting on the Bundle Items tab is self-explanatory.
What a bundle is
A bundle is a normal WooCommerce product whose type is set to Bundle Product. It has its own name, images, description, categories and — if you want — its own stock. What makes it special is the list of bundle items: references to other products in your catalog, each with a quantity.
On the storefront the bundle page shows a "This Kit/Bundle Includes:" box listing every item with its thumbnail, name, short description and quantity. Customers buy the bundle itself; the bundled products are recorded as its contents rather than as separate cart products.
Mandatory vs. optional items
The order of the items list matters. The Compulsory Items Count setting says how many items — counting from the top of the list — are always part of the kit. Every item after that position becomes optional: the storefront renders a checkbox next to it, unticked by default, and the customer decides whether to include it.
- Compulsory Items Count =
1with four items → item 1 is always included, items 2–4 are optional. - Compulsory Items Count empty or
0→ all items are mandatory and no checkboxes appear.
Variations are always included
An item that is a specific product variation (for example Hoodie – Black, L) is always treated as mandatory, even when it sits after the compulsory position. Only simple products become optional.
The two pricing modes
| Mode | What the customer pays | Typical use |
|---|---|---|
| Fixed Bundle Price | One flat price you type in, no matter which optional items are selected | "Everything for $5,999" package deals |
| Dynamic Bundle Price | The sum of the selected items' prices × their quantities | Pick-and-mix kits where the total should follow the selection |
In dynamic mode the product page shows per-item prices and a live Bundle Total; in the shop catalog the bundle is listed as "From: …" based on its mandatory items. Full details and worked examples: Pricing & Discounts.
Bundle discount
Independently of the pricing mode you can enable a bundle discount — a percentage or a fixed amount subtracted from the final bundle price. The storefront shows the original price struck through, the discounted price, and a green "You Save: $…" note that updates live.
Purchase limit
Max Purchase Limit caps how many units of the bundle a single order may contain. It is enforced when adding to the cart, when changing quantities in the cart, and in the block cart/checkout — customers see a clear error message when they exceed it. See Stock, Quantity & Limits.
One line item everywhere
However the customer configures the kit, the cart receives one line item for the bundle with its contents attached. Those contents follow the order through checkout, the order confirmation page, the customer's My Account order view, the admin order screen and order emails — each bundled product listed as "Included" / "Included inside bundle". Details: Cart, Checkout & Orders.
What the plugin deliberately does not do
Knowing the boundaries up front saves guesswork later:
- Bundled items are references, not separate order lines — child products' own stock counters are not reduced when a bundle sells (the bundle can have its own stock instead). See Stock, Quantity & Limits.
- There are no global settings pages — every option lives on the individual bundle product.
- Customers cannot change bundled item quantities on the product page; quantities per item are fixed by you. They choose optional items and the number of complete kits.
Next: check the full feature list or go straight to Installation.