Variation Swatches

Variation Swatches shows the options of variable products as colour, image, button or radio swatches, on product pages and in the shop.

Requirements

  • WordPress 6.8 or newer
  • WooCommerce 10.0 or newer
  • PHP 7.4 or newer
  • Works with classic themes and block themes using the Add to Cart form block, and with High-Performance Order Storage.

Installation

  1. Download variation-swatches.zip from My account > Downloads.
  2. In WordPress, go to Plugins > Add New Plugin > Upload Plugin, choose the zip file and click Install Now.
  3. Click Activate. Swatch types are set under Products > Attributes, and settings under WooCommerce > Settings > Products > Swatches.

Quick start

  1. Go to Products > Attributes and edit an attribute such as Colour.
  2. Choose Color as its swatch type and save.
  3. Click Configure terms, edit each value and set its colour.
  4. Open a product with that attribute: the dropdown is now swatches.

Swatch types

Each attribute gets a swatch type: Color, Image, Label (buttons) or Radio, a shape, a size and an optional note under its swatches. Attributes without a type follow the store setting.

An attribute’s swatch settings.
An attribute’s swatch settings.

Colours, pictures and labels

Each value gets a colour, a second colour for two-tone products, a picture, a short label and a tooltip on its edit screen. With Product Filters active, colours and pictures are set in its fields and shared.

A value with two colours and a tooltip.
A value with two colours and a tooltip.

One product

The Swatches tab on a variable product changes the type and the colours, pictures and labels for that product, including attributes added on the product itself.

The Swatches tab on a product.
The Swatches tab on a product.

On the product page

Swatches replace the dropdowns, with the chosen value next to the attribute name. Combinations that don’t exist are greyed out, and out-of-stock choices are crossed out, faded or hidden.

Swatches on a product page.
Swatches on a product page.

In the shop

Swatches of one attribute show under variable products in the shop, categories, search results and Product Collection blocks. A click changes the picture and price; products with one attribute can be added to the cart from there.

Swatches in the shop.
Swatches in the shop.

Settings

SettingWhat it does
Attributes without a typeShow as buttons, or as pictures when variations have them.
Shape and sizeCircle, square or rounded, and the size in pixels.
Out of stock optionsCrossed out, faded or hidden.
Chosen valueShow the chosen value next to the attribute name.
TooltipsShow the name, or a larger picture, on hover.
Border and selected colorsThe swatch border and the chosen swatch’s colour.
Swatches in shop listsShow swatches under variable products, which attribute, how many and their size.
Attribute filterColours and pictures in the Filter Products by Attribute widget.
Variations sent with the pageProducts with more variations load them as customers choose.

For developers

HookUse
vsva_swatchesChange the swatches of one attribute of a product.
vsva_settingsAdd or change settings.
vsva_share_filter_visualsChoose whether colours and pictures come from Product Filters.

Frequently asked questions

Why do some products still show dropdowns?

Block themes need the Add to Cart form block; the newer Add to Cart with Options block shows WooCommerce’s own selector.

Can I use the variation’s own picture?

Yes. Image swatches without a picture of their own use the variation’s picture.

How do I remove all data when deleting the plugin?

Add define( 'VSVA_REMOVE_ALL_DATA', true ); to wp-config.php before deleting the plugin.

Changelog

1.0.0 · October 21, 2026

  • Colour, image, button and radio swatches for variable products.
  • Per attribute, per value and per product settings.
  • Sold-out choices crossed out, faded or hidden.
  • Swatches in shop lists and the attribute filter.