New Woo brand announcement v2 | Feb 4, 2025

Added by Mahrie - https://woomarketingstudio.wordpress.com/2024/12/20/studio-request-logo-rollout-customer-comms/

Frequently Asked Questions

Basic Functionality

↑ Back to top

Some items do not appear or cannot be purchased in bundles, although they appear to be saved correctly.

↑ Back to top

Products that are part of a Product Bundle must have a price assigned, even when Priced Individually is unticked. WooCommerce does not allow products with a blank price to be purchased. Additionally, for variable products, the parent Variable Product must have a non-empty price. WooCommerce usually sets this automatically based on the lowest-priced variation., but some third-party plugins can interfere, causing the product to appear non-purchasable in Bundles.

If a Variable Product isn’t purchasable in a Bundle:

  1. Open the affected product.
  2. Edit a variation’s price (change it temporarily).
  3. Save the product.
  4. Revert the change and save again.

This forces WooCommerce to update its pricing data.

If that doesn’t resolve this then it’s likely that either:

  • a plugin conflict is affecting how WooCommerce saves product pricing, or
  • a product import issue has left some variation fields incomplete.

If the issue keeps happening, try identifying any theme or plugin conflicts. If it’s due to an import, updating the products manually (or in bulk) should resolve it.

For sites with many affected Variable Products, you can use the below snippet to refresh prices in bulk.

Note: We are unable to provide support for customizations under our Support Policy. If you need to customize a snippet or extend its functionality, we recommend working with a Woo Agency Partner or finding a WooCommerce developer on Codeable.

add_action( 'wp_loaded', 'resync' );

function resync() {

	if ( isset( $_GET( 'resync' ) ) ) {

		$products = wc_get_products( array(
			'type'     => 'variable',
			'paginate' => false,
			'return'   => 'objects'
		) );

		foreach ( $products as $product ) {
			$data_store = WC_Data_Store::load( 'product-' . $product->get_type() );
			$data_store->sync_price( $product );
		}
	}
}

Please note that this process can be resource-intensive. If your site has limited server capacity, check with your host before running it.

Once you have checked with your hosts, you can then run the snippet by visiting the link below:

https://yoursite.com/?resync=1

The add-to-cart button of a bundle cannot be clicked, or does not appear at all.

↑ Back to top

If the bundle does not contain any items that are Priced Individually, make sure that a price has been entered in the Regular Price field, located in the Product Data > General tab.

If this is in order, the cause might be due to a conflict with a third-party theme or plugin. To diagnose script-related issues with third party themes or plugins, follow this guide to see if there are any script-related errors in your browser. The easiest way to find the cause of such issues is to: (a) revert to a default WordPress theme and (b) start disabling plugins one by one, until you find the one that’s responsible.

Note that products added to bundles must have a non-blank price, as well.

My mini-cart widget does not show the correct count of cart items.

↑ Back to top

Bundle contents are not counted. A Bundle is counted as one item, no matter how many products it contains.

To include the individual bundled items in this count, use the following snippet:

 add_action( 'init', 'remove_pb_items_count_filters' );

function remove_pb_items_count_filters() {
	remove_filter( 'woocommerce_cart_contents_count',  array( WC_PB()->display, 'cart_contents_count' ) );
}

Note: We are unable to provide support for customizations under our Support Policy. If you need to customize a snippet or extend its functionality, we recommend working with a Woo Agency Partner or finding a WooCommerce developer on Codeable.

If your theme is counting cart items in a different way, ensure that it uses the WC()->cart->get_cart_contents_count() method to count cart items. If unsure how to verify this, share this information with your theme author(s).

The single-product details of my bundles appear squeezed.

↑ Back to top

Many WooCommerce themes place single-product summaries next to the main product image, which is ideal for displaying a short product description, a price and some metadata. Add-to-cart form content is normally displayed inside the single-product summary as well, which works very well for displaying simple or variable products.

However, this layout is not ideal for complex product types, such as Product Bundles, which require more space for their add-to-cart form content.

If the form content of your Product Bundles appears narrow or squeezed, choose the Form Location > Before Tabs option and see if it works better for you.

The availability status of specific bundles and/or bundled products is wrong.

↑ Back to top

In some rare cases, the availability status of bundles and/or bundled products might be reported incorrectly: For example, sufficiently-stocked bundles or bundled items may appear with an “Insufficient stock” status.

This issue is typically caused by product data import/export tools and bulk product editing plugins that bypass the WooCommerce APIs and write directly to the database.

If you are experiencing this problem, a temporary workaround is to disable stock status syncing for bundled items. This can be done by downloading, installing and activating this plugin:

View on Github

Note that this is not recommended as a long-term solution. Disabling the caching mechanism has a negative impact on server load, depending on the complexity of your bundles. If you are using a third-party plugin to manage stock, contact the plugin authors and bring this issue to their attention.

Is there a way to make some products available only in bundles?

↑ Back to top

In many cases, it is desirable to prevent customers from purchasing one or more bundled products individually. This is possible by changing the Visibility of these products to hide them from the catalog/search of your site.

To change the Visibility of a product:

  1. Edit the product.
  2. In the Publish panel, locate the Catalog Visibility option.
  3. Set the option to Hidden.
Setting a product’s visibility to Hidden.

Hidden products will still show up in the Bundles that contain them.

Some bundled items do not save when updating the product.

↑ Back to top

This is a very common issue on WP sites with lots of plugins (lots of data to post, process and save).

In most cases the default value of the max_input_vars parameter is 1000 — this means that only the first 1000 form fields are allowed to be processed and saved. Due to the amount of configurable fields added by Product Bundles on the edit-product page, a higher value is required to allow processing and saving lots of bundled items without issues.

The only way to fix this reliably is to ask your host to change this in their php.ini configuration file. Once this is done, it’s recommended to double check that the value has been changed correctly by navigating to WooCommerce > Status.

Setting it to at least 5000 usually resolves the problem.

How are fixed product discount coupons applied to Product Bundles?

When you apply a fixed product discount coupon to a Bundle, the fixed discount amount is applied both to:

  • the parent product, and;
  • any Priced Individually bundled items.

By default, coupon validity is inherited from the parent Product Bundle along with any applicable configuration, such as the discount amount.

If you require a fixed product discount coupon amount to be equally distributed among a number of bundled products, then some custom code will be required.

Note: We are unable to provide support for customizations under our Support Policy. If you need to customize a snippet or extend its functionality, we recommend working with a Woo Agency Partner or finding a WooCommerce developer on Codeable.

How do I add products to bundles in bulk?

↑ Back to top

Product Bundles does not include an option to bulk add simple products or entire categories as bundled items. However, you can achieve a similar result using one of the following methods.

Use the REST API

If you are familiar with the REST API and are using Product Bundles v5.2+, this is the recommended approach for creating bundles with multiple items. You can add products to a bundle by passing their ID via the API.

For step-by-step instructions, refer to our REST API documentation.

Use the WooCommerce Importer/Exporter

The WooCommerce Importer/Exporter tool allows you to export products, edit them, and re-import them into your store. You can access this tool under the Tools tab. In the exported CSV file, all bundled item data is stored in the Bundled Items (JSON-encoded) column. However,

  • If you haven’t used the Importer/Exporter tool before, test it on a staging site first.
  • If you don’t have a staging site, consider using a plugin like WP Staging.
  • Some hosting providers offer Control Panel options for creating staging environments. If you’re unsure, check with your host for the easiest way to set one up.

How do I bulk add Bundle-Sells to products in the same category?

↑ Back to top

You can use the WooCommerce Importer/Exporter to add Bundle-Sells to multiple products in the same category. Follow these steps:

  1. Add Bundle-Sells to one product in your store.
  2. Export all products from the same category using the WooCommerce Export tool (from Tools > Export)
  3. Open the exported CSV file and find the product from Step 1.
  4. Locate the “Bundle Sells” column in the CSV file.
  5. Copy the value from this column and paste it into the corresponding column for all other products in the same category.
  6. Import the modified CSV file back into WooCommerce and enable the option to update existing products during import.

This process applies the same Bundle-Sells settings to multiple products efficiently.

My website becomes slow/unresponsive when the extension is activated.

↑ Back to top

Bundling multiple variable products with a large number of variations may lead to slowdowns on shared hosting environments with limited resources. Running an e-commerce website requires a fast hosting environment with sufficient resources dedicated to complex database queries. Choosing a cheap or low-quality host hurts the uptime and performance of your store, resulting in lost sales and costly upgrades.

Poorly-coded themes can also have a serious impact on page-load speeds, especially when using complex extensions such as Product Bundles. If you are experiencing slow page loads on the front-end: (a) switch to the default WordPress theme and (b) disable all third-party plugins one by one, remembering to re-test after each change.

For the best possible performance, ensure that you are running the latest versions of WooCommerce and Product Bundles.

Product Bundles is giving me a failed loopback request error.

↑ Back to top

If loopback requests are not working correctly, it means your server is misconfigured and cannot send requests to itself. This can affect essential WooCommerce and WordPress functions, such as database updates and plugin installations.

For Product Bundles, this issue prevents bundled item stock from updating properly when a bundle is purchased. Unfortunately, this cannot be fixed by adding code to Product Bundles or your WordPress site.

Contact your hosting provider and request changes to allow loopback requests. When reaching out to your host, include a screenshot of the Tools > Site Health tab, as it provides more details about the issue.

Product Bundles is creating a database mismatch on my site.

↑ Back to top

A “Database Mismatch” indicates that:

  • Product Bundles failed to create the necessary tables in the database or;
  • a database update failed to complete successfully.

To resolve this issue, contact your site’s host to confirm whether your database user has permission to create new tables. If it does, rerun the database update to clear the notice.

Note: We are unable to provide support for customizations under our Support Policy. If you need to customize a snippet or extend its functionality, we recommend working with a Woo Agency Partner or finding a WooCommerce developer on Codeable.

To rerun the database update, install the below snippet:

add_action( 'init', 'sw_wc_pb_delete_options' );

function sw_wc_pb_delete_options() {

    if ( isset( $_GET[ 'delete_options' ] ) ) {
        delete_option( 'woocommerce_product_bundles_version' );
        delete_option( 'woocommerce_product_bundles_db_version' );
    }
}

And then visit the URL https://www.yoursite.com/?delete-options=1.

To confirm that this issue is resolved, navigate to WooCommerce > Status > System Status and check if the “database mismatch” notice has disappeared.

Why parent order items should appear in orders viewed in the Dashboard.

When a new order is placed, WooCommerce creates an order line item for:

  • the parent Bundle, and;
  • for each bundled item.

Every line item should be included in the admin orders screen to ensure correct accounting, as different line items may have different tax rates too. This is valid for Bundle parent/child items as well.

Moreover, including parent container items in WooCommerce orders is one of the extension’s core concepts, as you can read here.

Can I add a Product Bundle to the cart using a specially-constructed Add to Cart URL?

↑ Back to top

To create a custom Bundle Add to Cart URL, please follow the steps below:

  1. Edit the Bundle.
  2. Navigate to Product Data > Bundled Products.
  3. Check the ‘Edit in cart‘ option.
  4. Click Update.
  5. Click to view the Bundle and add it to the cart.
  6. In the cart, click the edit option.
  7. Remove the `update-bundle` parameter.
  8. Copy the URL.
  9. Add an `add-to-cart=$ID` parameter, replacing ‘$ID’ with the ID of the Product Bundle you are working on.

How do I add individual ‘Add to cart’ buttons to bundled items?

To display an add-to-cart button next to every bundled item, you need to use the add_to_cart shortcode.

  1. Navigate to Product Data > Bundled Products.
  2. Open the Bundled Item you wish to add a dedicated add-to-cart button to.
  3. Go the the Advanced Settings section.
  4. Check the Override Short Description box.
  5. Add the following shortcode: [add_to_cart id="108" show_price="false" style="border:0"]
  6. Replace 108 with the ID of the bundled product you’re working with

Can I automatically add a Bundle to the cart by adding the bundled items individually?

↑ Back to top

Product Bundles does not check which items are in the cart. Therefore:

  • A bundle will not be automatically added to the cart when all its bundled items are added individually, and
  • Individual products will not be removed and replaced with the bundled version when the bundle is added to the cart.

To suggest the bundle when customers add individual bundled items, you can set the bundle as a Cross-Sell for each product in the bundle. This will display the bundle as a recommendation in the cart whenever a bundled item is added.

How can I create bundle products programmatically?

↑ Back to top

Note: We are unable to provide support for customizations under our Support Policy. If you need to customize a snippet or extend its functionality, we recommend working with a Woo Agency Partner or finding a WooCommerce developer on Codeable.

The best way to create a Product Bundle programmatically is by making a REST API call.

For more details, refer to the WooCommerce Product Bundles REST API documentation.

Alternatively, you can create a Product Bundle programmatically using the set_bundled_data_items method.

This function expects each bundled item’s data in an array format. For reference, see WC_Bundled_Item_Data::get_data().

Example: Adding a Simple Product to a Product Bundle

$data_items = array(
array(
'product_id' => $simple_product->get_id(), // Replace with product IDs.
'meta_data' => array(
'priced_individually' => 'yes',
'shipped_individually' => 'no',
'quantity_min' => 1,
'quantity_max' => 2,
'discount' => 50
)
),
);

$product_bundle->set_bundled_data_items( $data_items );
$product_bundle->save();

This method allows you to programmatically define bundled items, set pricing and shipping options, and apply quantity restrictions or discounts.

Compatibility and Integrations

↑ Back to top

Is there a way to automatically recommend bundles that contain the currently viewed product?

↑ Back to top

Yes. This can be achieved by using Product Bundles in combination with Product Recommendations.

P​roduct Recommendations allows you to automatically recommend all bundles that contain the currently viewed product by utilizing the Product Bundle filter:

  • Create a new recommendation engine
  • Set Product as the Engine Type.
  • Configure the engine to Filter on Product Bundle.
  • Deploy the engine.
  • Customize the display, appearance, and visibility conditions of the recommendations.

How does Product Bundles work with WooCommerce Subscriptions?

↑ Back to top

Subscription-type products can be added to Product Bundles without issues, and it’s even possible to bundle Subscription-type products with different billing schedules.

Note that when you add Simple/Variable Subscriptions to a Product Bundle, Priced Individually is enabled by default.

This is essential as Bundles are not subscription-type products, which means they can’t have a billing schedule of their own: They can only act as “containers” of subscription-type products. Un-checking Priced Individually will make bundled subscription products “lose” their recurring billing schedule.

If you’d like to offer a discounted price for bundled Subscriptions, please use the Discount option, which is displayed when Priced Individually is enabled.

Note that when customers purchase a Product Bundle that contains Subscription-type products, the parent item is only used to keep the bundled Subscription products grouped until the initial order is placed. The created Subscription(s) will not contain a parent/container item! If you are looking for a way to offer entire Bundles on subscription, check out our use case on this.

Why don’t I see express payment/quick pay buttons on my product pages with bundles? 

Product bundles do not support quick-pay buttons on the product pages. These buttons are not currently compatible with forms that have multiple fields on the product page.

Is there a way to create Subscription Bundles?

↑ Back to top

The go-to solution for offering entire Product Bundles on a subscription is to use WooCommerce Subscriptions in combination with the All Products add-on.

Issues with auto-optimizer plugins.

↑ Back to top

Auto-optimizer plugins prevent Product Bundles scripts from running, which causes issues with the extension’s basic functionality. More specifically, when auto-optimizer plugins are used, Product Bundles animations and price updates do not function properly.

Is the extension compatible with [insert plugin/extension name here]?

↑ Back to top

The official WooCommerce extensions supported by Product Bundles are listed in the Compatibility and Integrations section. Third-party extensions/plugins are not supported.

I have an issue with WPML!

↑ Back to top

For compatibility with WooCommerce, WPML relies on the WooCommerce Multilingual plugin.

Product Bundles does not support WPML directly. If you are experiencing any issues, please reach out to WPML support.

Customizations

↑ Back to top

I need an advanced customization.

↑ Back to top

Customizations are not covered under our Support Policy. However, we encourage you to have a look at the available mini-extensions and snippets. If the customization you are looking for is not included there, please seek assistance from a WordPress/WooCommerce developer. We highly recommend working with a Certified WooExpert. For general pointers, you can always get in touch with our Support Team.

Is there a way to edit a text string in the plugin?

↑ Back to top

You can use a plugin such as Loco Translate to edit text strings. This is the best way to customize WooCommerce text strings, as the edits will not be overwritten when plugins are updated.

After activating Loco Translate:

  1. Go to Loco Translate > Plugins and click Product Bundles.
  2. Click on New Language.
  3. Choose the desired or your site’s default language in the dropdown menu.
  4. Select Custom in the Choose a location option.
  5. Press Start Translating.
  6. Search for the string you want to edit.
  7. Select it and add your modification.
  8. Press Save.

For more details visit Generating a New Translation.

How can I change the “Add for” string I see next to Optional bundled product checkboxes?

↑ Back to top

“Add for” is a compound string that consists of two strings: Add%1$s%2$s%3$s and for %s.

Orders and Fulfillment

↑ Back to top

Is it possible to manually add/modify bundles in editable orders?

↑ Back to top

Yes, you can manually add and modify Product Bundles in editable orders.

If a bundle contains configurable items, a Configure button appears next to the order item title. Clicking this button opens a modal where store managers can select configuration options and add the configured bundled items to the order.

For bundles without configurable items, all bundled products are automatically added to the order along with the main bundle item—no further action is needed.

Metadata Limitations When Editing Bundles

While bundles can be edited, any metadata attached to bundled items (such as Add-Ons) is lost during the process. This happens because the system removes, modifies, and re-adds items to ensure bundled products remain grouped under the main bundle. Since metadata is not compared between the old and new order items, it is not retained.

Workaround for Metadata Preservation

You can use the woocommerce_editing_bundle_in_order action to retrieve both the old and new order item configurations and decide which metadata to keep. However, this has limitations:

  • Metadata, such as Add-Ons, cannot be edited in the order context.
  • If new bundled items are added during an order edit (such as optional items), they will not retain any metadata.

The reason this workaround is not fully implemented in the extension is that bundles undergo cart validation when first added to an order. However, when edited through the Configure modal, they do not go through the same validation process.

Note: We are unable to provide support for customizations under our Support Policy. If you need to customize a snippet or extend its functionality, we recommend working with a Woo Agency Partner or finding a WooCommerce developer on Codeable.

Questions & Support

↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.
Already purchased and need assistance? Get in touch with us via the Help Desk!