---
title: "Get started with Products Compare"
url: "https://kestrelwp.com/docs/get-started-with-products-compare/"
description: "Let shoppers compare products side by side on a compare page."
published: "2026-10-06T20:23:18+00:00"
modified: "2026-11-10T19:11:05+00:00"
---

Products Compare lets shoppers tick the products they’re weighing up and see them side by side on a compare page: image, price, rating, stock, SKU, short description and attributes, each with its own add to cart button. An optional widget keeps the running list in a sidebar.

![Products Compare: overview](https://kestrelwp.com/wp-content/uploads/2026/10/products-compare-pc-01.png)There’s no settings screen: the plugin works as soon as it’s active. Each shopper’s list is kept in their browser, not their account, and products are compared as a whole, not by variation.

## When you’d use this

- Help shoppers choose between similar products, such as two models of the same item.
- Show the attributes that set products apart, like size, material or capacity, in one table.
- Keep a running compare list in your sidebar while shoppers browse.

## Requirements

- WordPress 6.3 or later, WooCommerce 8.2 or later, and PHP 7.4 or later.
- Compatible with WooCommerce’s cart and checkout blocks and High-Performance Order Storage.
- The **Products Compare for WooCommerce** widget needs a theme with widget areas.

## Install and activate

- **Bought on kestrelwp.com:** install the plugin by following [how to install and update WooCommerce extensions](/docs/install-update-woocommerce-extensions/), then activate your license key under **Settings » Products Compare for WooCommerce activation** to receive updates.
- **Bought on WooCommerce.com:** install the plugin from your WooCommerce.com account. Updates come through your WooCommerce.com connection, with no license key to enter.

## Set up Products Compare

### 1. Activate the plugin

Activate Products Compare under **Plugins**. There’s nothing to configure: a **Compare** checkbox appears with each product on your shop and category pages, and on single product pages.

### 2. Tick two products

Open your shop in a private browser window and tick **Compare** on two products.

### 3. Open the compare page

Click the small icon next to either checkbox. The compare page opens at `/products-compare/` on your site, for example `https://example.com/products-compare/`, with the two products side by side. The address carries the products, for example `/products-compare/?products=12,34`, so a shopper can bookmark or share the comparison.

### 4. Add the widget (optional)

To show the running list in a sidebar, go to **Appearance » Widgets** and add the **Products Compare for WooCommerce** widget to a widget area. See [Widget settings](#widget-settings).

## Where the compare checkbox appears

- **Product lists** (shop, category and tag pages): after each product’s add to cart button. On block themes, the checkbox follows every **Add to Cart Button** block, so it also appears in Product Collection blocks on other pages.
- **Single product pages:** below the add to cart form.

Themes and page builders that build product lists or product pages without WooCommerce’s standard hooks, or block layouts without the **Add to Cart Button** block, show no checkbox.

## How the compare list works

- **It lives in the shopper’s browser.** The list is saved in the browser’s local storage for 7 days. It isn’t tied to the shopper’s account, so it doesn’t follow them to another browser or device, and clearing browsing data empties it. Because the page reads the list in the browser, comparing works for guests and on shop pages served from a cache.
- **Five products at most.** Ticking a sixth shows "Sorry, a maximum of 5 products can be compared at one time." and leaves it unticked.
- **Two products at least.** With fewer than two ticked, the compare icon and the widget’s **Compare Products** button show "Please add at least 2 or more products to compare." instead of opening the page.
- **Whole products only.** A variable product is compared as one product. Its variations can’t be added on their own.
- **Only published products.** Drafts, private products and products hidden from the catalog can’t be compared; search-only and out of stock products can.
- **Browser storage required.** A shopper whose browser blocks storage sees "Sorry, you must have cookies enabled in your browser to use compare products feature".

The limit, how long the list is kept and the page’s address can be changed with code: see the [Products Compare developer reference](/docs/products-compare-developer-reference/).

## What customers see

### The compare page

The page is titled **Products Compare**. Each product gets a column with its image, name, sale badge, add to cart button and a **Remove Product** link. Below that come a **Ratings** row (when at least one product has reviews) and a **Price** row.

The rows after that show **Stock** for products that track stock, **SKU**, **Description** (each product’s short description) and one row per attribute set to show on the product page. A product with nothing for a row has an empty cell. The name, price and add to cart button repeat at the bottom.

**Remove Product** takes the product’s column away, along with any row that’s left empty. When the last product is removed, or a shopper opens the page with nothing ticked, the page says "Sorry you do not have any products to compare." with a **Return to Shop** button. Shoppers with JavaScript turned off see "Sorry, you must have Javascript enabled in your browser to use compare products".

### The compare page on block themes

On a block theme with WordPress 6.7 or later, such as Twenty Twenty-Five, the compare page uses the **Products compare** template, so it shows your theme’s header and footer like the rest of your store. To change it, go to **Appearance » Editor » Templates** and open **Products compare**. The template holds the **Products compare table** block between your header and footer; add blocks around it, such as a heading or a note about delivery, and save it like any other template. The **Products compare table** block belongs in this template only: placing it on other pages or templates isn’t supported. In the editor the block shows the empty compare page, because there are no products to compare while you edit.

If your theme has its own copy of the compare page template, that copy is used instead. See the [developer reference](/docs/products-compare-developer-reference/).

### The widget

The widget lists the ticked products, each with a **Remove Product** link, plus **Remove all products** and a **Compare Products** button. Products appear in it as soon as they’re ticked. With nothing ticked, it shows its **Default text**.

![Products Compare: The widget (storefront Shop page)](https://kestrelwp.com/wp-content/uploads/2026/10/products-compare-pc-04.png)## Widget settings

Set these on the **Products Compare for WooCommerce** widget under **Appearance » Widgets**.

- **Title**: the heading above the list. Default "Compare products".
- **Default text**: what the widget says when nothing is ticked. Default "Add some products to compare."

## Common issues

### The Compare checkbox doesn’t appear

Your theme or page builder probably builds product lists without WooCommerce’s standard product hooks. On a block theme, check that the product list includes the **Add to Cart Button** block, since the checkbox is added after it. Switch to Storefront for a moment to confirm, then ask your theme’s author whether their layouts support WooCommerce’s product hooks.

### Ticking Compare does nothing

The checkbox needs the plugin’s JavaScript. Check your browser console for errors, and if you use an optimization plugin that combines, defers or delays scripts, exclude jQuery and the Products Compare script, or turn the plugin off to test.

### The compare page is empty or shows the wrong products

The compare page shows the products in its address (`?products=12,34`). A link that was shortened or had its query string stripped loses them, and the page is empty for a visitor with no ticked products of their own. The page tells caches not to store it, but some hosts and optimization plugins ignore that: exclude `/products-compare/` from the page cache if it still shows someone else’s products. Drafts, private and catalog-hidden products are left out.

### The compare page says "Page not found"

Go to **Settings » Permalinks** and click **Save Changes**. That rebuilds WordPress’s addresses, including the compare page’s.

### "Sorry, a maximum of 5 products can be compared at one time."

The shopper already has five products in their list. They can remove one with **Remove Product** on the compare page or in the widget. To allow more, see the [developer reference](/docs/products-compare-developer-reference/#woocommerce-products-compare-max-products).

### "Please add at least 2 or more products to compare."

The compare page opens only with two or more products ticked. Tick another product, then click the compare icon again.

### A shopper’s list disappeared

The list is kept for 7 days in the browser it was made in. It’s lost after that, when browsing data is cleared, and in another browser or a private window. Lists saved by version 1.4 or earlier aren’t carried over, so shoppers’ open lists start empty after updating to 1.5.0.

### Variations can’t be compared

Products Compare works with whole products. To compare options side by side, show them as attributes set to show on the product page, and they get their own row on the compare page.

## Keep learning

- [Products Compare developer reference](/docs/products-compare-developer-reference/) (templates, and filters for the page address, limit and rows)
- [How to install and update WooCommerce extensions](/docs/install-update-woocommerce-extensions/) (installing, updating and fixing upload errors)
- [How to add custom CSS to your site](/docs/how-to-add-custom-css-to-your-site/) (styling the checkbox and compare page)
- [Changing text in a plugin](/docs/changing-text-in-a-plugin/) (rewording the checkbox, alerts and page text)
