Configuration

Versus is configured on one screen: the Versus menu in wp-admin (it needs the standard WooCommerce capability). Everything below lives there.

Enable comparison

The master switch. When off, no compare buttons render and the comparison view is hidden, without uninstalling.

Products compared at once

The cap on how many products a single comparison list can hold, between 2 and 6. When a shopper adds a product beyond the cap, the oldest item is dropped to make room, so the list never grows past your limit.

Button placement

Choose where the Compare button appears:

• Shop and archive loops — on product cards in the shop, category and tag listings.
• Single product page.

Each placement is toggled independently.

Allow guests

When on, logged-out visitors can compare too. A guest’s list is stored per browser and is merged into their account when they log in. When off, comparison is for logged-in customers only.

Compared fields

Choose which standard fields appear as rows in the comparison table:

• Price
• SKU
• Availability (stock status)
• Short description

You can also toggle whether product attributes (colour, size, material and so on) are included — each attribute becomes its own row.

Difference highlighting

• Highlight differences — rows whose values differ between the compared products are visually emphasised, so the real distinctions stand out from the shared specs.
• Differences only by default — start the table with identical rows hidden, so shoppers see only what separates the products. They can toggle the identical rows back on.

Column header controls

For each product column in the table, you can show or hide:

• the product image,
• an add-to-cart control,
• a remove control.

This lets you keep the header compact or make it a fully actionable mini product card per column.

Labels and text

A Labels & text section lets you customise the front-end strings without translation files:

• the compare button,
• the remove button,
• the compare link,
• the differences toggle,
• the clear-all button,
• the empty-list message.

Leave any field blank to fall back to its translated default. The plugin is fully translation-ready through the versus text domain (a versus.pot template ships in /languages), so you can translate it the usual way instead.

Where the comparison opens

The comparison table opens on the Compare tab in My Account for logged-in customers, and at a dedicated compare URL for guests.

Accessibility and performance

The compare buttons are real buttons with an aria-pressed state that updates over AJAX, wired to a polite live region that announces changes to screen readers. The table scrolls horizontally inside its own wrapper, so adding columns never reflows the page (no layout shift). The front-end script is vanilla JavaScript — no jQuery — deferred and loaded in the footer.

Clean uninstall

Deleting the plugin removes its options and the comparison-items table, leaving your database as it was.