FAQ

Does it require WooCommerce?

Yes. Versus is a WooCommerce extension and requires WooCommerce 8.0 or later. It shows an admin notice and stays inactive if WooCommerce is missing.

Does it use jQuery?

No. The plugin’s own front-end script is vanilla JavaScript, loaded defer in the footer, with no jQuery dependency.

Can guests compare products?

Yes, when Allow guests is on. A guest’s list is stored in a versus_compare_session cookie for six months and is transferred into their account when they log in, so nothing is lost at sign-in. When the setting is off, clicking Compare sends visitors to log in first.

Where does the compare button appear?

On shop and archive loops and on the single product page, depending on your settings, each placement is toggled independently.

Where does the comparison open?

On the Compare tab in My Account for logged-in customers (when the Account menu setting is on), or at the versus-compare endpoint URL for guests.

The My Account Compare tab returns a 404. Why?

The Compare tab registers a rewrite endpoint, and WordPress only flushes rewrite rules when permalinks are saved. After first enabling Account menu, go to Settings → Permalinks and click Save Changes once.

How many products can be compared?

Between 2 and 6, set by the Maximum products setting (default 4). When a shopper exceeds the cap, the oldest product is removed automatically to make room.

What fields can the table show?

Each product is a column with its image, name and (optionally) add-to-cart and remove controls in the header. The rows are the standard fields you enable, price, SKU, availability and short description, plus an optional row for each product attribute the compared products define.

What is difference highlighting?

Rows whose values differ between the compared products are tinted. A “show only differences” toggle hides the identical rows so shoppers see just what separates the products, and you can make that the default.

Can I change the button and link wording?

Yes. The Labels & text section overrides the compare button, remove button, compare link, differences toggle, clear-all button and empty-list message. Leave a field blank to use its translated default.

Is there a shortcode?

No. In the free edition the button and table render automatically wherever WooCommerce fires its loop, single-product and account hooks. There is no shortcode and no theme template override.

Is it translatable?

Yes. All strings use the versus text domain and a versus.pot template ships in /languages, so WordPress loads translations automatically for the plugin slug.

Is it accessible, and does it cause layout shift?

The compare buttons are real buttons with an aria-pressed state and a polite live region for screen-reader announcements, with visible focus and full keyboard support. The table scrolls horizontally inside its own wrapper and reserves space for product images, so adding columns never reflows the page, no Cumulative Layout Shift.

Where are comparisons stored?

In a single {prefix}versus_compare_items table in your own database, one row per product-and-owner pair (owner is a user id or a guest session id). Nothing is sent to any third party.

What happens when I delete the plugin?

The uninstall routine removes the versus_settings and versus_db_version options and drops the {prefix}versus_compare_items table, leaving your database as it was.