Configuration

Bundle is configured in two places. The global settings page (WooCommerce → Bundle) controls store-wide behaviour, the discount mode and the box wording. The Bundle tab in the product editor holds each product’s actual bundle, the companions and its discount. Global settings are stored in the bundle_settings option (an array); per-product definitions are stored as the product’s _bundle_definition meta.

The settings page requires the manage_woocommerce capability, so shop managers, not only administrators, can edit and save it.

Global settings

Display

• Enable bundles (enabled, on by default), the master switch. When off, no bundle box renders anywhere and no bundle discount is applied; products keep selling normally.
• Show on product page (show_on_single, on by default), render the box automatically below the product summary (on woocommerce_after_single_product_summary) for any product that has a bundle. Turn off to place the box only with the [bundle] shortcode.
• Show bundled items (show_items, on by default), list each companion with its thumbnail and price inside the box. Off gives a compact box with just the title, savings line and button.
• Show savings (show_savings, on by default), show the bundle total and the exact amount saved (for example Bundle total $84.00, you save $12.00). This line only appears when a discount percentage is set on the product.

Discount

Discount mode (discount_mode), how the discount reaches the cart. The percentage itself is set per product, not here.

• Single cart fee (fee, the default), one negative line in the cart and at checkout (e.g. Bundle discount −$12.00). Simplest and clearest.
• Per-item price adjustment (per_item), lowers the price of each bundled line instead, so the saving is reflected on every product and in per-product tax. The adjustment applies only to lines added through a bundle button, not to the same product added on its own.

Labels & wording

Each label is editable and translatable. Leave a field blank to use the default shown as its placeholder.

• Box title (box_title), the heading at the top of the box. Default: Frequently bought together.
• Add-to-cart label (add_label), the text on the button that adds the whole set. Default: Add bundle to cart.
• Discount line label (fee_label), the wording of the negative fee line in the cart and checkout when Single cart fee mode is used. Default: Bundle discount. It is not used in per-item mode (there is no separate line then) and it is not the wording of the on-box savings line, which is built-in.

Each field on this page has a keyboard- and screen-reader-accessible ”?” help bubble (a native popover) explaining the option.

Per-product bundle definition

Edit the lead product and open the Bundle tab in the Product data panel (available for simple and variable products):

• Bundled product IDs, a comma-separated list of companion product IDs (e.g. 42, 108, 256). On save, blanks, duplicates and the product’s own ID are dropped, and the list is capped at 50 items. An empty list deletes the bundle definition.
• Bundle discount (%), an optional percentage off the combined price, clamped to 0-100. 0 means no discount; the box still cross-sells the items.

Robustness and fallbacks

• Companion IDs that no longer resolve to a product (deleted, trashed) are skipped when the box renders, and the box hides entirely when none resolve, a stale ID never leaves a broken box or a lone “Add bundle” button.
• At add-to-cart, a companion that is not purchasable or is out of stock is skipped and a notice is shown; the remaining items are still added.
• Blank label fields fall back to the packaged defaults both in the admin and on the storefront.

Storage and uninstall

• Global settings: the bundle_settings option.
• Migration marker: the bundle_db_version option.
• Per-product bundles: the _bundle_definition post meta on each lead product.

Deleting the plugin from the Plugins screen runs the uninstall routine, which removes bundle_settings, bundle_db_version and every _bundle_definition meta row. No custom database tables are ever created, so none are dropped.

Choosing bundle products

The free edition lists companions by ID in the Bundle tab. Bundle Pro replaces the ID field with WooCommerce’s native product search. See Bundle Pro.