Gatemi Bought Together FAQ and Troubleshooting

The box does not show on my product

Check, in this order:

  1. WooCommerce → Bought Together → Show the box on product pages is on.
  2. The product's Product data → Bought together tab lists at least one product id, and No box on this product is not ticked.
  3. The product itself can be bought right now: purchasable (it has a price), in stock, and not a variable, grouped or external product. The main product is held to the same rule as its companions, because the button always adds it first.
  4. At least one companion can be bought right now: published and visible, purchasable, in stock, and a simple product or a variation. If every companion fails one of these, the plugin shows no box at all, on purpose.
  5. Your theme fires WooCommerce's woocommerce_after_single_product_summary hook on the product page. Most themes do. A block theme's single-product template without the classic product content may not; the full edition's [gatemi_bought_together] shortcode places the box anywhere.

I named a variable product and it is missing

That is deliberate. A variable product needs a size or colour chosen before it can go in a cart, and the box has no place to ask. Name the specific variation instead — edit the variable product, open Variations, and use the id shown beside the one you want (#245).

Can I show the box on a variable product's page?

No. A variable product needs a size or colour chosen before it can go in a cart, and the box always adds its main product, so a variable, out-of-stock or not-for-sale product shows no box at all. Otherwise the button would add the companions alone, which is not the set the shopper was shown. Use the box on simple products; a variation can still be a companion.

Does it work with page caching?

Yes. The box is ordinary HTML, so a cached page shows it. The button sends a WooCommerce AJAX request with a nonce. On a page cached for longer than a nonce lasts (12 to 24 hours), a press may answer "Your session has expired. Please reload the page and try again." — exclude product pages from long caches, or keep the cache under a day.

Stock is checked again when the button is pressed, so a cached page never puts a sold-out product in the cart.

Does it work with the Cart and Checkout blocks?

Yes. Products go in through WooCommerce's own cart, and the full edition's discount is set on the cart's own price calculation, which the Cart block, the Checkout block and the Store API all use. Both editions declare compatibility with the blocks and with HPOS.

The mini-cart did not update after pressing the button

The plugin triggers WooCommerce's added_to_cart event with the refreshed cart fragments. A theme whose mini-cart does not listen for that event will show the new items on the next page load.

Full edition: the discount disappeared

The discount is only earned while the main product and every companion added from the box are in the cart. Removing one prices the rest back at their own price. Adding one of them again from its own page does not restore it, because that line did not come from the box.

Full edition: a category rule is not applied

  • The product has a set of its own — a product's own set always wins.
  • No box on this product is ticked on it.
  • A rule higher in the list matches first. Rules are first-match, top to bottom.
  • The rule's companions are all unavailable (see the first question).

Can a shopper use the box to add a product I did not list?

No. The server only adds ids that are part of the product's current set, whatever was posted.

Moving from the free edition to the full edition

Install and activate the full edition. The free edition stands down and says so on the Plugins screen. Every set (_gmbt_items), the No box switches and the box settings are shared, so nothing is re-entered. Carts in progress and past orders keep their "part of a set" record.

Going back from the full edition to the free one

Your discounts and category rules stay stored but are not used: the free edition shows only the product's own set, without a discount. Companions beyond the third are kept on the product.

What happens when I uninstall?

Free edition: removes gmbt_settings and the _gmbt_items and _gmbt_disabled product meta — but only if the full edition has never been set up on the site (no stored gmbt_license). Otherwise it removes nothing.

Full edition: removes gmbt_settings, gmbt_rules, the licence, its update cache and cron event, and all four product meta keys.

Neither edition touches past orders: the _gmbt_set and _gmbt_discount notes on order lines stay.

Next

Shopping Cart
Scroll to Top