Getting Started with Gatemi Bought Together

These docs cover both editions:

  • Gatemi Bought Together — the free edition, coming to wordpress.org.
  • Gatemi Bought Together for WooCommerce — the full edition, sold on gatemi.com.

Anything marked Full edition is only in the paid plugin. Everything else is in both.

The plugin puts a "Frequently bought together" box under a product: the product itself, the companions you chose for it, a checkbox beside each, a running total and one button that adds the ticked products to the cart.

Requirements

Free edition Full edition
WordPress 6.4 or later 6.4 or later
PHP 7.4 or later 7.4 or later
WooCommerce 8.0 or later (tested up to 10.9) 8.0 or later (tested up to 10.9)

Both editions declare compatibility with WooCommerce's High-Performance Order Storage (HPOS) and with the Cart and Checkout blocks. No database tables are created.

1. Install

Free edition: coming to wordpress.org. Until it is listed there, it is not available to install from Plugins → Add New.

Full edition: download the zip from your gatemi.com account, then go to Plugins → Add New → Upload Plugin, upload it and activate. Open WooCommerce → Bought Together and enter your licence key in the License & updates card to switch on one-click updates. The plugin works without a key; the key is for updates and support.

You only need one edition. If both are active, the free edition stands down and says so in a row under its entry on the Plugins screen: "the full edition of Gatemi Bought Together is active and running your sets. You can safely deactivate the free one." Both read the same sets and the same settings, so nothing is lost.

2. Check the store-wide settings

Go to WooCommerce → Bought Together (you need the manage_woocommerce capability — shop managers and administrators have it).

The Bought Together settings screen
The settings screen: the heading, the button wording and whether thumbnails show.

The defaults work as they are: the box is on, the heading reads "Frequently bought together", the button reads "Add all to cart", and each row shows a thumbnail. Change any of them and press Save Changes (in the full edition, Save changes). See Settings for each one.

3. Give a product its companions

Sets are written on the product itself.

  1. Go to Products and edit the product the box should appear on.
  2. In the Product data box, open the Bought together tab.
  3. In Bought together with, type the ids of the products that go with it, separated by commas, for example 112, 118, 240. A product id is the number in the address bar (post=112) when you edit that product.
  4. Update the product.

The free edition takes up to three companions per product; the full edition up to six.

Name simple products or specific variations. A variable product (the parent) needs a choice the box does not ask for, so if you name one it is left out of the box. To offer "the blue mug, large", find that variation's id and type that.

Full edition: in the same tab, choose a Discount for taking the set (a percentage or a fixed amount) and type the Amount. See How it works for when the discount is earned and when it comes off again.

4. Check the product page

Open the product in a private window. Under the product summary (before the description tabs, on a standard theme) you should see the box:

The frequently bought together box on a product page
The box on a product page — the product, its companions, a running total and one button.
  1. Every row starts ticked. Untick one and the total changes.
  2. Press Add all to cart. A message under the button says how many products were added, and the mini-cart refreshes.
  3. Open the cart. Each line added from the box carries the note Bought together: Part of a set.

If no box appears, see FAQ and troubleshooting — the most common reason is that every companion is out of stock, unpublished or a variable product, or that the product itself is variable or out of stock — in each case the plugin shows no box at all.

Full edition: rules for whole categories

Under WooCommerce → Bought Together → Category rules you can give every product in chosen categories (sub-categories included) the same companions, so you do not have to edit each product. A product with a set of its own ignores every rule. The full edition also has a [gatemi_bought_together] shortcode for placing the box somewhere else.

Next

Shopping Cart
Scroll to Top