Using Bundle

This walkthrough follows one bundle from the product editor to a discounted cart, then covers discount modes and shortcode placement.

1. Build the bundle

Edit the lead product of the set, for a camera, the camera itself. Open the Bundle tab in the Product data panel:

1. In Bundled product IDs, enter the companions’ IDs, comma-separated: 108, 256 (a memory card and a bag).
2. Set an optional Bundle discount (%), say 10 for 10% off the combined price.
3. Save the product.

The saved definition lives in the product’s _bundle_definition meta. There is no separate “bundle product” type, any existing product becomes a bundle lead by getting a definition.

2. What the shopper sees

Open the lead product on the storefront. Under the summary the box shows:

• The title (your Box title, or Frequently bought together).
• The main product and each companion with a thumbnail and price, joined by + (when Show bundled items is on).
• A “Buy together and save 10%” line and a bundle total / amount saved line (when a discount is set and Show savings is on).
• The add-to-cart button (your Add-to-cart label, or Add bundle to cart).

The box markup is server-rendered; there is no storefront JavaScript and no jQuery. Thumbnails reserve their space, so the box does not shift the page as images load, and its colours follow the visitor’s dark-mode preference.

3. The one-click add

Clicking the button posts the bundle (a nonce-guarded request) and redirects to the cart. The lead product and every companion that is purchasable and in stock are added, each tagged with the lead product’s ID so the discount can find them. If a companion can’t be added, out of stock, not purchasable, it is skipped and WooCommerce shows the notice Some bundled products could not be added to the cart. The rest still go in.

4. The discount in the cart

The percentage from the Bundle tab is applied at cart calculation, the way Discount mode (under WooCommerce → Bundle) dictates:

• Single cart fee, one negative line (your Discount line label, default Bundle discount) totalling the saving across all bundled lines. Cleanest for shoppers reading the totals.
• Per-item price adjustment, each bundled line’s price is reduced by the percentage, so the saving is spread across the lines and into per-product tax. Only lines added through the bundle are touched; the same product added on its own keeps full price.

Choose cart fee for one clear promo line; choose per item when each line must reflect its share.

5. Place the box yourself

To put the box somewhere other than under the summary, turn off Show on product page and drop the shortcode where you want it:

[bundle]
[bundle id="123"]

[bundle] uses the current product in the loop; [bundle id="123"] targets a specific product. Either way the box renders only when that product has a resolvable bundle, and only when Enable bundles is on, so it never prints an empty box. This suits landing pages and custom product templates.

When companions go missing

If a companion is deleted or trashed, Bundle skips it when rendering and when adding to the cart. If no listed companion still resolves, the box hides itself, a stale ID never leaves a broken box on the page.

Customising the markup

The box template ships inside the plugin and is rendered directly; there is no theme template-override path and no storefront filter to alter the markup. Restyle the box with CSS against its classes (.bundle-box, .bundle-box__items, .bundle-box__add, .bundle-box__savings). Deeper layout changes are part of Bundle Pro (mix-and-match layouts).

When to reach for Pro

The free edition covers a fixed set of companions, an optional percentage discount, both discount modes and the shortcode. Bundle Pro adds a product-search picker, a fixed bundle price, order-history suggestions, tiered quantity pricing, mix-and-match layouts, scheduled deals and bundle analytics. See Bundle Pro.