The "This kit contains" list does not show
The list is printed on WooCommerce's woocommerce_before_add_to_cart_button hook, so check:
- The product has at least one valid part saved — open it and look at Kit contents. A row with an empty ID or quantity 0 is not saved.
- The part still exists. A deleted part is dropped from the list.
- The product page shows an add-to-cart button. A theme or page builder that draws its own button without WooCommerce's hooks will not show the list.
Why was my kit refused at add-to-cart?
The message names the part, how many are in stock and how many the kits need. Kits already in the cart are counted: if the cart holds two kits, adding a third checks the parts for three. See How it works.
Does selling a kit reduce the parts' stock?
Free edition: no. The kit sells as one product and only its own stock changes. Manage the kit's own stock, or adjust the parts by hand.
Full edition: yes. Each bundled item is a real cart and order line, and WooCommerce reduces its stock like any other line.
How is a kit priced?
At the kit product's own regular or sale price. The free edition adds no price of its own.
The bundle shows "From:" instead of a price range
Full edition. "From:" is used when the top price is open — an individually priced item with no Max quantity, or quantities the shopper chooses. A fixed range would be wrong there, so the lowest price is shown.
Can I bundle a variable product?
Free edition: a part is one product ID. Use a variation's own ID to put a specific variation in a kit.
Full edition: yes. Add the variable product; the shopper chooses a variation on the bundle's product page. Use Allowed variations to limit which ones.
Does it work with the Cart and Checkout blocks?
Yes. Both editions declare compatibility. The free edition's stock check runs on WooCommerce's add-to-cart validation and the kit is one ordinary line. Full edition: the same checks run through the Store API, and an item's quantity in the block cart moves in whole bundles.
Does it work with HPOS?
Yes. Both editions declare High-Performance Order Storage compatibility. The Contains row and the full edition's bundle details are written through WooCommerce's order item API.
My page cache shows the wrong stock note
The contents list and the "(out of stock)" note are part of the product page's HTML, so a full-page cache can show an old state until the page is regenerated. The add-to-cart check is never cached: a kit the parts cannot cover is refused whatever the cached page said. Clear the product page from your cache after a restock if the note matters to you.
A bundled item cannot be removed from the cart
Full edition. That is deliberate for a mandatory item: removing it would leave a bundle missing part of its contents. Remove the whole bundle, or mark the item Optional if shoppers may leave it out.
I upgraded from the free edition. Where are my kits?
The free edition's contents list (_gmpbf_items) and the full edition's bundles (_gmpb_bundled_items, on the Product bundle type) are stored differently — a contents list on a simple product, against a Product bundle product type. Changing a product's type is your decision rather than a migration's, so nothing is converted on its own:
- Until you convert it, a kit keeps selling as a kit. The full edition reads the free edition's contents list and keeps its three promises: the contents are listed on the product page, adding the kit is refused while a part is out of stock (counting the kits already in the cart), and the order line records Contains. It never writes to that list.
- Convert when you are ready. WooCommerce → Bundles license lists every kit on the store with what it contains. Tick the ones to convert and press Convert the selected kits. Each becomes a Product bundle with the same parts at the same quantities — every part included and fixed, none priced on its own — so it sells at the kit's own regular and sale price, grouped, with nothing else switched on.
- What changes: a bundle's parts are real lines on the order, so from then on the parts' own stock goes down when the bundle sells. A sale price that runs on a schedule is not carried (a bundle's base price has no sale dates) — set it again on the bundle. A part the free edition would not have sold (a draft, a product in the bin, a variable product) is left out.
- It is reversible. The contents list stays on the product, untouched; change the product type back to Simple product and it is a kit again. Activating the full edition deletes nothing, so deactivating it brings the kits back too.
What does uninstalling remove?
Free edition: the _gmpbf_items meta on every product — unless the full edition has ever been configured on the store (its gmpb_license or gmpb_settings option exists), in which case nothing is deleted, so removing the free edition after upgrading keeps every kit. The Contains rows already on orders stay — they are order history.
Full edition: always the gmpb_settings option, the reverse index (gmpb_reverse_index), the licence state, the cached update payload and the licence-check cron event. The bundles themselves (items, base prices, layout and the rest) are deleted only if Also delete every bundle's configuration is ticked on WooCommerce → Bundles license (delete_data in gmpb_settings). Order lines are never touched.
Can I deactivate the plugin for a while?
Yes. Nothing is deleted on deactivation. Full edition: while it is inactive WooCommerce no longer knows the Product bundle type, so those products cannot be bought until you reactivate it.
