Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Getting started

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

Bundle works as soon as WooCommerce is active. The feature ships enabled, so the only setup that matters is linking companion products to a product, the box appears automatically once a product has a bundle defined.

Before you start

Section titled “Before you start”
  • WordPress 6.5 or newer
  • WooCommerce 8.0 or newer (HPOS and Cart/Checkout Blocks declared compatible)
  • PHP 8.1 or newer

Bundle requires WooCommerce. With WooCommerce inactive it shows an admin notice and does nothing, it registers no hooks.

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Bundle from the plugin directory (when live on WordPress.org), or upload the bundle folder to /wp-content/plugins/.
  3. Activate it.

There is no setup wizard. The default settings (box enabled, shown under the product summary, items and savings shown, single-cart-fee discount mode) suit most stores.

Build your first bundle

Section titled “Build your first bundle”
  1. Edit the product that will lead the set, for a camera, this is the camera itself.
  2. Open the Bundle tab in the Product data panel (it appears for simple and variable products).
  3. In Bundled product IDs, enter a comma-separated list of the companion products’ IDs, e.g. 42, 108, 256. The product ID is in the URL while editing a product and in the ID column under Products.
  4. Optionally set a Bundle discount (%), the percentage off the combined price when the whole set is added. Leave it at 0 to cross-sell without a discount.
  5. Save the product.

Duplicates, blank entries and the product’s own ID are dropped automatically, and the list is capped at 50 companions. An empty list removes the bundle definition entirely.

Verify on the product page

Section titled “Verify on the product page”
  1. Open the lead product on the storefront.
  2. Below the product summary you should see the bundle box: the title, each item with a thumbnail and price (if Show bundled items is on), a “save X%” line and the bundle total/savings (if a discount is set and Show savings is on), and the add-to-cart button.
  3. Click the button. The lead product and every purchasable, in-stock companion are added to the cart; if any companion can’t be added, WooCommerce shows a notice.
  4. Open the cart and confirm the discount: a single negative line (fee mode) or reduced bundled-line prices (per-item mode).

If the box doesn’t appear, check that the product has at least one resolvable companion ID, the box hides itself when no listed product exists, and never shows when Enable bundles is off.

Settings worth a look

Section titled “Settings worth a look”

Open WooCommerce → Bundle:

  • Enable bundles, the master switch; off means no box and no discount anywhere.
  • Show on product page, turn off to place the box only with the [bundle] shortcode.
  • Discount mode, single cart fee vs. per-item adjustment.
  • Box title, Add-to-cart label, Discount line label, the words shoppers read.

See Configuration for every field and its option key.

Free vs Pro

Section titled “Free vs Pro”

The free edition covers the full flow: a fixed set of companions, an optional percentage discount, both discount modes, the savings line 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 analytics. See Bundle Pro.

Need help?

Section titled “Need help?”