Free Plugin

Sayan Variation Swatches
for WooCommerce

Replace WooCommerce dropdowns with color, image, label, and radio swatches on product, shop, and archive pages. Everything described on this page is included in the free plugin — no key or account needed.

Applies to version 1.0.7  ·  Last updated October 26, 2026

v1.0.7 WP 7.1 Tested WC 7.0+ PHP 7.4+ HPOS Ready GPL-2.0

Overview & Features

Sayan Variation Swatches for WooCommerce is a lightweight WooCommerce plugin that replaces the default variation dropdown selects with visually rich swatches — color pickers, image tiles, label buttons, and radio selectors.

4 Swatch Types

Color, Image, Label/Button, and Radio — each with full customization.

3 Swatch Shapes

Square, Rounded, and Circle — set globally or override per attribute term.

Archive Page Swatches

Show compact swatches on shop, category, and archive pages.

Variation Image Auto-Swap

Gallery image updates instantly on swatch click — no AJAX, zero lag.

Dual / Split Colors

Show two colors in a single swatch with a diagonal split gradient.

Out-of-Stock Handling

Blur with cross, blur only, or hide unavailable swatches automatically.

Notify Me Message

Optional message and link when a shopper picks an unavailable option.

Smart Variation Finder

Optional search box on product pages. Off until you enable it.

Export / Import

Move your settings between sites with a JSON file.

Live Settings Preview

See product and shop swatches change as you edit shape, size, colors and tooltip.

Live Swatch Preview

Below is a preview of how each swatch type renders on your product page:

Color Swatches

Selected: Ocean Blue

Label / Button Swatches

XS
S
M
L
XL
2XL
Selected: M

Radio Swatches

S
M
L

System Requirements

ComponentMinimumRecommended
WordPress6.47.0+
WooCommerce7.0Latest stable
PHP7.48.3+
MySQL / MariaDB5.6 / 10.18.0+ / 10.4+
BrowserChrome 90+, Firefox 88+, Safari 14+, Edge 90+

Installation

Method 1 — WordPress Admin (Recommended)

1

Upload the plugin

Go to Plugins → Add New → Upload Plugin, choose the sayan-variation-swatches.zip file, and click Install Now.

2

Activate

Click Activate Plugin after installation completes.

3

Configure

Go to Variation Swatches in the left WordPress admin menu to adjust global settings.

4

Set up attributes

Go to Products → Attributes, click any attribute name, then edit individual terms to assign swatch types and colors.

Method 2 — Manual FTP

# Unzip and upload to your plugins directory
unzip sayan-variation-swatches.zip
# Upload the folder via FTP to:
/wp-content/plugins/sayan-variation-swatches/

Then activate from Plugins → Installed Plugins.

WooCommerce must be installed and activated before activating this plugin. If WooCommerce is missing, an admin notice will appear.

Swatch Types

The plugin supports 4 swatch types plus the default dropdown. Set the type on each attribute term, or override it for a single product (see Setting Up Attribute Swatches).

Custom (local) attributes: colors and images are stored on global attribute terms, so Color and Image swatches need a global attribute (Products → Attributes). A custom attribute typed into a single product can only be shown as Label or Radio swatches.
TypeBest ForData Required
ColorColor variants, fabric shades, paint optionsHex color (+ optional second color for dual)
ImagePatterns, textures, material previewsUpload an image per term
LabelSizes (S/M/L/XL), styles, materials as textNone — uses term name
RadioYes/No options, simple choicesNone — uses term name
SelectKeep as default WooCommerce dropdownNone

Admin Screenshot — Attribute Term Edit

WordPress Admin — Products → Attributes → pa_color → Edit Term
≡ WordPress ⬤ Products All Products Add New Attributes ◈ WooCommerce Edit Color: Ocean Blue Edit Term: Ocean Blue Name Ocean Blue Slug ocean-blue Swatch Type Color ▾ Select how this attribute will be displayed as a swatch. Swatch Color #2563eb Choose the swatch color. Second Color (Dual) No color Optional: second color for a split/dual swatch. Update
Products → Attributes → Edit any attribute → Edit a term — set Swatch Type, Color, and optional Second Color

Dual / Split Color

When you fill in both the Swatch Color and Second Color fields, the swatch renders as a diagonal split — useful for multicolor or two-tone fabric options.

Dual-color swatches using diagonal gradient

Swatch Shapes

Three shape options are available globally from Variation Swatches → General → Core settings → Swatch shape. To use a different shape for one attribute value (for example Circle for colors, Square for sizes), edit the term and choose Swatch Shape Override. It applies on product pages and archive pages.

Square

Sharp 90° corners. Clean and modern.

Rounded

Soft corners. Default and most versatile.

Circle

Fully round. Ideal for color swatches.

Archive / Shop Page Swatches

Enable compact swatches on your shop, category, and archive pages so customers can preview color options without clicking into each product.

Enable this from Variation Swatches → Shop / Archive with the switch in the Swatches on shop and archive pages card. You can also set a smaller swatch width and height specifically for archive pages.

  • When a product has more options than fit, a +N badge shows how many are hidden.
  • Archive swatches also appear inside the WooCommerce Product Collection and All Products blocks.
  • Archive swatches are built from global attributes only.
Tip: Archive swatches let shoppers see the available colors without opening each product page.

Archive swatch clicks

By default archive swatches are display-only. Under Variation Swatches → Shop / Archive → Archive swatch clicks you can switch on two options (both are off by default, and both are dimmed while archive swatches are off):

OptionWhat it does
Swap the product imageClicking a swatch replaces the product image with that variation's image. Only variations that have their own image are used; other swatches just highlight. Click the swatch again to restore the original image.
Open the product with the option selectedAfter a swatch is clicked, links to that product open the product page with the same option already selected (for example ?attribute_pa_color=red).
Swatches become keyboard accessible when either option is on (Enter or Space). The image swap reads each product's variations, so enable it only if you need it on large catalogs.

Swatch Filter

The Swatch Filter lets shoppers narrow the shop by one attribute (for example Color), using the same color, image or label swatches you set up on the attribute terms.

1

Add it

Block themes: in the Site Editor (or a sidebar) add the Swatch Filter block. Classic themes: go to Appearance → Widgets and add Swatch Filter.

2

Choose the attribute

Pick a global attribute in the block settings (or the widget form). You can add a heading; otherwise the attribute name is used.

3

Check the shop

The filter appears on the shop page and on product category, tag and attribute pages. Clicking a swatch reloads the page with that option; click it again to remove it, or use Clear filter.

  • It uses WooCommerce's own filter_ links, so the filtered URL can be shared and bookmarked.
  • Several values of the same attribute are combined with OR (Red or Blue).
  • The list shows every term of the attribute that is used by at least one product. It does not show product counts.
  • Terms without a swatch type are shown as text labels. Filter links use rel="nofollow".
Your theme or the shop template must use WooCommerce's standard product query for the filter links to take effect. Please test it on your own shop.

Variation Image Auto-Swap

When a customer clicks a swatch, the main product gallery image automatically updates to show the matching variation image — with no page reload and no AJAX request. It happens as soon as one swatch is chosen: for example clicking Black shows the black product even while Size is still unselected.

How it works

1

Set variation images in WooCommerce

In the product editor, go to Product data → Variations. For each variation, upload a dedicated image using the variation image picker (the small camera icon).

2

Plugin builds image map at page load

When the product page loads, the plugin reads all variation images and embeds a slug → image data map directly into the swatch HTML. No AJAX calls are ever made.

3

Swatch click triggers instant swap

Clicking a swatch updates the gallery <img> src, srcset, sizes, and alt, the lightbox link, the zoom and lightbox image data, and the first gallery thumbnail. The transition is immediate. The image used for a swatch is the first variation with that option that has its own image. Once every option is chosen, WooCommerce shows the exact variation's image.

4

Deselect restores original image

Clicking a selected swatch again (or pressing the WooCommerce "Clear" button) restores the product's original main gallery image.

If a variation does not have a dedicated image set (i.e. it uses the parent product image), no swap occurs for that swatch. Only variations with unique images trigger the gallery update.

Choose which swatches swap the image

Under Variation Swatches → General → Product image swap → Swap image on:

  • All swatch attributes (default): every swatch attribute can swap the image.
  • Only color and image swatches: attributes shown as label or radio swatches, such as Size, never change the image. Use this when Color and Size both have a variation image and a click on a size should not change the color shown.

Out-of-Stock Styles

Choose a style under Variation Swatches → General → Core settings → Out-of-stock style. Each option is shown as a small picture, so you can see the result before you save. Three options are available:

StyleAppearanceBest For
Blur with Cross Default Swatch is faded (38% opacity) with a diagonal line across it Most stores — clearly communicates unavailability
Blur only Swatch is faded without the cross line Cleaner look when the cross feels too aggressive
Hide Out-of-stock swatches are completely removed Stores where showing unavailable options causes confusion
Available
Blur+Cross
Blur only

Notify Me Message

When a shopper picks an option that is not available, a short message appears under the swatches. Configure it under Variation Swatches → General → Out-of-stock "Notify me". The switch is in the card header, and the fields below it are dimmed while it is off:

SettingDefaultDescription
Notify me (card switch)YesTurns the message on or off.
Message textNotify me when availableUp to 80 characters.
Link URLEmptyOptional. Only http and https links are accepted. Leave empty and only "This option is currently unavailable." is shown, without a link.

Tooltip

When enabled, hovering over any swatch shows a small label with the attribute term name (e.g. "Ocean Blue", "Size M"). By default it appears above the swatch; you can move it to the bottom, left or right.

Customize the tooltip from Variation Swatches → Design & Style → Tooltip style. The live preview shows a tooltip on the selected swatch, so you can check the position and colors before you save. The Tooltip style card is dimmed while tooltips are switched off.

Position

Top, Bottom, Left or Right of the swatch. Set under Variation Swatches → Design & Style → Tooltip style → Position. Default: Top

Background color

Background color of the tooltip bubble. Default: #333333

Text color

Text color inside the tooltip. Default: #ffffff

Font size

Font size in pixels (10–24px). Default: 13px

Enable/Disable

Use Variation Swatches → General → Core settings → Tooltip on hover.

Smart Variation Finder

The Smart Variation Finder adds a small search box above the swatches on variable product pages. A shopper can type words such as "dark blue large" and the matching swatches are selected for them.

1

Turn it on

Go to Variation Swatches → General, switch on the Smart Variation Finder card, then click Save changes.

2

Try it on a product

Open a variable product page, type an option name in the Find a variation box and pick a suggestion.

The finder is off by default on new installs. Stores that were already using it when they updated to 1.0.6 keep it on. It runs in the browser and contacts no external service.

Setting Up Attribute Swatches

Important: By default, swatch types are set at the term level (individual attribute values). Each color/size option gets its own type and data. You can also override the type for a single product (see below).

Step-by-Step: Setting up Color Swatches

1

Go to Products → Attributes

Find your Color attribute (e.g. pa_color) in the list.

2

Click the attribute name

This opens the term list for that attribute — you'll see all color options (Red, Blue, Green, etc.).

3

Edit each term

Click Edit next to a term (e.g. "Ocean Blue"). You'll see the plugin's new fields at the bottom of the edit form.

4

Set Swatch Type to "Color"

The Swatch Color field will appear. Click it to open the color picker and choose the color.

5

Optionally add a Second Color

Fill in the Second Color field to create a dual/split swatch.

6

Click Update

Repeat for each term. Your product pages will now show color swatches instead of the dropdown.

Step-by-Step: Setting up Image Swatches

1

Edit the attribute term

Follow steps 1–3 above for your texture or pattern attribute.

2

Set Swatch Type to "Image"

The Swatch Image uploader will appear.

3

Upload or select an image

Click Upload / Select Image to open the WordPress Media Library. Choose or upload your image. Recommended size: at least 80×80px.

4

Click Update

The image thumbnail will be shown in both the term list (Swatch column) and on the product page.

Per-Product Swatch Type

1

Add a global attribute to the product

In the product editor open Product data → Attributes, add the attribute and click Save attributes (or update the product).

2

Choose a type

Below the attribute list, under Swatch type for this product, pick a type for each attribute. Leave — Use attribute setting — to keep the term settings.

3

Update the product

The override applies to that product only and takes precedence over the term settings.

Per-Term Shape Override

Edit an attribute term and use Swatch Shape Override to give that value its own shape. Choose — Use Global Setting — to follow the global shape.

Settings — General

Access settings at Variation Swatches → General in the WordPress admin.

WordPress Admin — Variation Swatches → General
Variation Swatches General settings tab: Core settings with switches and visual options, and a live product preview on the right
Variation Swatches → General — Core settings, with the live product preview on the right

Settings screen at a glance

  • Tabs across the top: General, Design & Style, Shop / Archive, Advanced and Pro Features. Each tab saves on its own and never resets the settings on the other tabs.
  • Live preview on the General, Design & Style and Shop / Archive tabs. Use Product and Shop to switch views, and click the sample swatches to try them. The preview updates as you change shape, size, colors, tooltip, out-of-stock style and more, before you save. It is a sample store, so your theme may change spacing and fonts on the real pages. On narrow screens the preview moves above the settings and can be hidden with Hide.
  • Feature switches in card headers (Notify me, Smart Variation Finder, Block product page, shop and archive swatches, Custom CSS). While a switch is off, the settings inside that card are dimmed and cannot be edited.
  • Unsaved changes bar: when you change something, a bar appears at the bottom with Discard and Save changes. Your browser also warns you if you try to leave the page with unsaved changes.
  • Setup guide: a short three-step guide at the top of the General tab. Dismiss it with the × button and it stays hidden in that browser.
SettingDefaultDescription
Enable swatchesYesMaster switch. Turning it off reverts all product pages to the default WooCommerce dropdowns. The label next to the plugin name at the top of the screen shows Swatches live or Swatches off.
Convert dropdowns automaticallyNoWhen on, any attribute term that has no swatch type saved yet is shown as a label/button swatch instead of a dropdown.
Show the selected nameYesShows the chosen option next to the attribute name (for example "Color: Ocean Blue").
Tooltip on hoverYesShows the option name when a shopper hovers over or focuses a swatch. Style it under Design & Style → Tooltip style.
Swatch shapeRoundedGlobal shape: Square, Rounded, or Circle. Can be overridden per attribute term.
Out-of-stock styleBlur with CrossHow unavailable swatches appear. Options: Blur with Cross, Blur only, Hide.
Out-of-stock "Notify me" (card switch)YesShows a message when a shopper picks an unavailable option. See Out-of-Stock Styles.
Message text / Link URLNotify me when available / emptyText (max 80 characters) and optional http/https link for the message.
Smart Variation Finder (card switch)NoAdds the search box on product pages. See Smart Variation Finder.
Product image swap → Swap image onAll swatch attributesWhich swatches change the main product image: all swatch attributes, or only color and image swatches. See Image Auto-Swap.
Block product page (card switch)NoShows color and image swatches on the pills of WooCommerce's Add to Cart + Options block (WooCommerce 10.6+). See Block Product Pages.

Settings — Design & Style

Find these at Variation Swatches → Design & Style. The live preview on the right shows every change straight away.

WordPress Admin — Variation Swatches → Design & Style
Variation Swatches Design and Style tab: style presets, swatch size and color settings, and a live product preview on the right
Variation Swatches → Design & Style — Style presets, swatch size and colors, with the live preview
SettingDefaultDescription
Swatch size → Width36Swatch width on product pages (20–120px). Use the slider or type a number.
Swatch size → Height36Swatch height on product pages (20–120px).
Border color#ddddddDefault border color for unselected swatches. Use the color box or type a hex value.
Selected border color#333333Border color when a swatch is selected.
Checkmark on selected swatchYesDraws a checkmark over the chosen color or image swatch.
Checkmark color#ffffffColor of the checkmark. Dimmed while the checkmark is off.
Tooltip style → PositionTopTop, Bottom, Left or Right of the swatch.
Tooltip style → Background color#333333Tooltip background.
Tooltip style → Text color#ffffffTooltip text color.
Tooltip style → Font size13pxTooltip font size (10–24px).

Colors are saved as hex values such as #dddddd. A value that is not a valid hex color falls back to the default when you save. The Tooltip style card is dimmed while Tooltip on hover is off on the General tab.

Style Presets

At the top of Variation Swatches → Design & Style you can apply a ready-made look in one click. Each preset card shows a small preview of its swatches. The preset that matches your current settings is marked Active, and the label next to the Style presets heading shows Custom when your settings match none of them.

PresetLook
DefaultRounded swatches with a soft grey border.
MinimalSmall square swatches, thin light border, no checkmark.
BoldLarge circles with a strong blue selection.

Clicking Apply asks you to confirm. A preset changes the swatch shape, sizes, border and selection colors, checkmark and tooltip colors. It does not switch features on or off and does not touch your custom CSS. Your previous settings are saved first, so you can click Undo last preset to go back.

Settings — Shop / Archive

SettingDefaultDescription
Swatches on shop and archive pages (card switch)YesDisplay compact swatches on shop, category, and archive pages. The size fields and the click options are dimmed while it is off.
Swatch width28pxWidth of archive page swatches (16–80px).
Swatch height28pxHeight of archive page swatches (16–80px).
Archive swatch clicks → Swap the product imageNoA click replaces the product image with that variation's image. See Archive swatch clicks.
Archive swatch clicks → Open the product with the option selectedNoLinks to that product open the product page with the same option already selected.

Custom CSS

Access at Variation Swatches → Advanced → Custom CSS. Switch on Custom CSS in the card header and paste your CSS into the Stylesheet box. All swatch elements use the .svsw-* class prefix. Only administrators can edit custom CSS; HTML tags and @import rules are removed when you save.

Useful CSS Classes

ClassDescription
.svsw-swatches-wrapOuter wrapper for each attribute's swatch group
.svsw-swatchesFlex container holding all swatches
.svsw-swatchIndividual swatch element
.svsw-type-colorColor swatch type
.svsw-type-imageImage swatch type
.svsw-type-labelLabel/button swatch type
.svsw-type-radioRadio swatch type
.svsw-swatch.selectedCurrently selected swatch
.svsw-swatch.svsw-unavailableOut-of-stock swatch
.svsw-tooltipTooltip bubble
.svsw-selected-nameSpan showing selected attribute name
.svsw-archive-swatchesArchive page swatch container
.svsw-shape-squareApplied when shape is square
.svsw-shape-roundedApplied when shape is rounded
.svsw-shape-circleApplied when shape is circle

CSS Custom Properties

The plugin injects these CSS variables dynamically based on your settings. You can override them in your custom CSS:

:root {
  --svsw-width: 36px;               /* Product page swatch width */
  --svsw-height: 36px;              /* Product page swatch height */
  --svsw-archive-width: 28px;       /* Archive swatch width */
  --svsw-archive-height: 28px;      /* Archive swatch height */
  --svsw-border-color: #dddddd;     /* Default border */
  --svsw-selected-border-color: #333333; /* Selected border */
  --svsw-checkmark-color: #ffffff;  /* Checkmark color */
  --svsw-tooltip-bg: #333333;       /* Tooltip background */
  --svsw-tooltip-color: #ffffff;    /* Tooltip text */
  --svsw-tooltip-font-size: 13px;   /* Tooltip font size */
}

Example: Make label swatches pill-shaped

.svsw-type-label .svsw-swatch {
  border-radius: 50px !important;
  padding: 0 16px;
  min-width: auto;
}

Example: Larger color swatches only

.svsw-type-color .svsw-swatch {
  width: 48px !important;
  height: 48px !important;
}

Example: Custom selected state highlight

.svsw-swatch.selected {
  box-shadow: 0 0 0 3px #ff6b35 !important;
}

Export / Import & Data

Find these options at Variation Swatches → Advanced. Export and import are available to administrators.

Export and import settings

1

Export

Click Download settings (JSON). The file contains the plugin settings only; swatch colors and images saved on attribute terms are not included.

2

Import

On the other site open Variation Swatches → Advanced → Export / Import settings, click Choose a .json file, select the file and click Import settings. Only a .json file exported from this plugin, up to 64 KB, is accepted. Unknown or invalid values are rejected.

Delete data on uninstall

Turn on Delete data on uninstall (Advanced → Data; a red warning appears while it is on) if you want the plugin's settings and the swatch values saved on terms and products removed when you delete the plugin. It is off by default, so your swatches survive a reinstall.

Keyboard Navigation & Accessibility

All swatches are fully keyboard-navigable and screen-reader friendly. They use role="radio", aria-checked, aria-label, and tabindex="0".

KeyAction
TabMove focus to the swatch group
→ / ↓Move to the next swatch
← / ↑Move to the previous swatch
Enter / SpaceSelect the focused swatch
EscapeDeselect the current swatch

Block Product Pages (Add to Cart + Options)

Block-based single product pages can use WooCommerce's Add to Cart + Options (Beta) block (WooCommerce 10.6 and newer). That block draws the attribute options itself, as pills or as a dropdown, so the classic swatch form is not used there.

Show your swatches on the pills

1

Use the pills option

In the Site Editor, select the attribute options inside the block and choose Pills as the option style.

2

Turn on the styling

Go to Variation Swatches → General, switch on the Block product page card (marked WooCommerce 10.6+) and click Save changes. It is off by default.

  • Color, dual-color and image terms are shown with your swatch look and shape. Terms set to Label stay as normal WooCommerce pills.
  • WooCommerce still handles the selection, availability and clearing. The plugin only adds the look.
  • Attributes set to the dropdown option, and custom (local) attributes, are not changed.
  • The image swap and the Smart Variation Finder work with the classic add-to-cart form only, not in this block.
The block is still marked Beta by WooCommerce and its markup may change. If the styling does not appear, switch the option off and tell us on the support forum.

Compatibility

✅ WordPress 7.1

Tested up to WordPress 7.1. The plugin uses taxonomy term screens, the product editor attribute panel and its own settings page.

✅ WooCommerce HPOS

High-Performance Order Storage compatibility explicitly declared. No order data is touched by this plugin.

✅ WC Blocks

Cart & Checkout Blocks compatibility declared. Swatches operate on the product page and do not touch the block cart/checkout.

✅ Variable Products

Full support for variable products. Works with all standard WooCommerce variation selectors and the wc-add-to-cart-variation script.

✅ Popular Themes

Built on standard WooCommerce hooks, so it is designed to work with most themes, for example Storefront, Astra and GeneratePress. Please check your own theme before going live.

✅ WPML / Polylang

Translation-ready. All strings use the sayan-variation-swatches text domain and a .pot file is included. Attribute term names follow your multilingual plugin. Please test your own setup.

✅ Product Blocks

Archive swatches work inside the Product Collection and All Products blocks.

✅ Elementor & Quick View

Product page swatches re-initialize in Elementor product widgets and quick view popups. On archive pages in Elementor Loop Grid or Loop Builder, swatches appear when the template runs WooCommerce's standard product loop hooks — please test your template.

Free vs Pro

The free plugin is complete and fully functional on its own. Nothing in it is locked or time-limited. A separate Pro plugin adds extra features for stores that want them.

FeatureFreePro
Color, dual-color, image, label and radio swatchesIncludedIncluded
Shop and archive swatches, product blocksIncludedIncluded
Out-of-stock styles and Notify Me messageIncludedIncluded
Design controls, tooltips, custom CSS, export / importIncludedIncluded
Smart Variation FinderIncludedIncluded
Sticky Add-to-Cart bar—Pro
Per-swatch badges—Pro
Multi-gallery per variation—Pro
Bulk swatch generator—Pro
Live stock badge—Pro

Pro is a separate plugin and is not installed from inside the free plugin. More at webtend.net.

Frequently Asked Questions

My swatches are not showing. What should I check?

Ensure: (1) Enable swatches is switched on in Variation Swatches → General (the label at the top of the screen shows Swatches live when it is). (2) Each attribute term has a Swatch Type set — go to Products → Attributes → edit any attribute term. (3) The product uses a global attribute (custom attributes only support Label and Radio swatches). (4) WooCommerce is active and up to date. (5) If you use a caching plugin, clear the cache.

Can I set different swatch types for different products?

Yes. In the product editor, go to Product data → Attributes, save the attributes, then use Swatch type for this product below the attribute list. The override applies to that product only and takes precedence over the term settings.

The variation image is not swapping when I click a swatch.

Ensure the variation has a dedicated image set in the product editor (Variations tab → each variation row → the small camera icon). If a variation uses the parent product image, no swap occurs. Only variations with unique images trigger the swap.

My theme has a custom gallery. Will image swap still work?

The plugin updates the standard WooCommerce gallery img element, the wrapping a href (for lightboxes), and fires the woocommerce_gallery_reset_slide_position event. Most themes built on WooCommerce standards will work. If your theme uses a completely custom gallery, you may need a small CSS/JS integration.

How do I remove all plugin data when uninstalling?

Turn on Variation Swatches → Advanced → Delete data on uninstall and click Save changes. When you then delete the plugin (not just deactivate it), its settings, term meta and post meta are removed. With the option off, your data is kept.

Is there a Pro version?

Yes, as a separate plugin. It adds a sticky add-to-cart bar, per-swatch badges, per-variation galleries, a bulk swatch generator and a live stock badge. The free plugin stays fully functional on its own. See Free vs Pro.

Does it work with WooCommerce's new Add to Cart + Options block?

Partly. Turn on the Block product page switch under General to show color and image swatches on that block's pills. The image swap and the Smart Variation Finder need the classic add-to-cart form. See Block Product Pages.

How do I add the Swatch Filter to my shop?

Add the Swatch Filter block in the block editor, or the Swatch Filter widget under Appearance → Widgets, then choose an attribute. See Swatch Filter.

What do archive swatch clicks do?

Under Variation Swatches → Shop / Archive you can let a click swap the product image and open the product page with that option selected. Both are off by default. See Archive / Shop Page Swatches.

Where are the style presets?

At the top of Variation Swatches → Design & Style. Use Undo last preset to restore your previous settings.

What is the live preview on the settings screen?

A sample product page and shop page that update as you change settings on the General, Design & Style and Shop / Archive tabs, before you save. Use Product and Shop to switch views, and click the sample swatches to try them. It is a sample store, so your theme may change spacing and fonts on the real pages.

Why are some settings dimmed?

A setting is dimmed when the feature it belongs to is switched off. For example the Tooltip style card is dimmed while Tooltip on hover is off, the checkmark color while the checkmark is off, the archive size and click options while shop and archive swatches are off, and the Notify me fields while Notify me is off. Switch the feature on and the settings become editable again.

Can I change the tooltip direction?

Yes. Go to Variation Swatches → Design & Style → Tooltip style → Position and choose Top, Bottom, Left or Right. The live preview shows the new position right away.

What is the Smart Variation Finder and how do I turn it on?

It is a search box on product pages that selects matching swatches from typed words. Enable it under Variation Swatches → General → Smart Variation Finder. See Smart Variation Finder.

Does it support custom (local) attributes?

Partly. Color and Image swatches need global attributes because the colors and images are stored on attribute terms. A custom attribute on a single product can be shown as Label or Radio swatches.

Will it slow my store?

The plugin's CSS and JavaScript load on product, shop and archive pages and wherever a swatch is rendered, not on every page. It makes no external requests.

Does the plugin collect data or contact external servers?

No. It does not collect personal data and makes no external requests.

Can I use custom CSS to style swatches differently per attribute?

Yes. Use the attribute name in the selector via the data-attribute attribute on the wrapper:

/* Style only the color attribute swatches */
.svsw-swatches-wrap[data-attribute="pa_color"] .svsw-swatch {
  border-radius: 50%;
}

/* Style only the size attribute swatches */
.svsw-swatches-wrap[data-attribute="pa_size"] .svsw-swatch {
  min-width: 48px;
  font-size: 13px;
}
Still having issues? Visit the WordPress.org support forum for this plugin.

Changelog

This page mirrors the changelog in the plugin's readme.txt.

1.0.7

NewStyle Presets under Design & Style (Default, Minimal, Bold) with undo
NewSwatch Filter block and widget to filter the shop by one attribute
NewArchive swatch clicks under Shop / Archive: swap the product image and open the product with the option selected (both off by default)
New"Product Image Swap" option under General: swap the image on all swatch attributes (default) or only color and image swatches; zoom, lightbox and thumbnail now follow the swap
NewOptional swatch styling for the pills of WooCommerce's Add to Cart + Options (Beta) block (off by default)
ImprovedRedesigned settings screen with a live preview of product page and shop page swatches, a clearer layout and an unsaved-changes bar
FixedThe Notify Me message now appears when a shopper clicks an unavailable swatch; its link shows only when a URL is set
DevNew filters svsw_filter_terms, svsw_style_presets and svsw_filter_swatch_html, and action svsw_style_preset_applied

1.0.6

NewPro Features tab under Variation Swatches with an overview of the separate Pro plugin
NewSmart Variation Finder switch under General (off for new installs, stays on for existing stores)
New"Delete Data on Uninstall" switch under Advanced (off by default)
NewPer-product swatch type on the product's Attributes panel
NewDocs and Support links on the Plugins screen and in the settings header
ImprovedCSS and JavaScript now load only on product, shop and archive pages and where swatches are shown
ImprovedThe review notice counts login sessions, appears only on the Dashboard, Plugins and settings screens, and has a permanent "Don't ask again" button
FixedSettings Export / Import now works on the Advanced tab
FixedTooltip Position and the Notify Me text and link can now be changed in the settings
FixedThe per-term shape override is now applied on product and archive pages
Fixed"Show Selected Name" now works, and "Auto-convert dropdowns" now converts unset attributes to label swatches (off by default)
FixedShop managers can now save the plugin settings
FixedBlock archive swatches no longer appear when swatches are switched off
FixedA PHP error when rendering archive swatches
SecurityStricter custom CSS (administrators only), http and https only for the Notify Me link, escaped output, capability check when saving term swatches
DevNew filter svsw_load_assets to load the swatch assets on a custom page

1.0.5

NewWooCommerce Product Blocks compatibility for Product Collection (WC 8.0+) and All Products blocks
NewOut-of-Stock Notify Me message with optional link
NewTooltip Position setting under Design & Style
NewSelected swatch highlight animation that respects prefers-reduced-motion

1.0.4

NewElementor Loop Builder compatibility for archive swatches
NewSettings Export / Import
NewPer-attribute term shape override
NewStyled "Clear Selection" button
ImprovedAdmin term list column shows a type badge, shape badge and a more accurate preview

1.0.3

NewReview notice, archive "+N more" badge, attribute label next to swatches, Quick View compatibility
ImprovedSettings are read once per request instead of once per swatch
Fixed"Tested up to" values, plugin name and Author URI

1.0.2

FixedSaving settings on one tab reset the other tabs to defaults

1.0.1

NewCompatibility guard so the plugin runs next to Sayan Variation Swatches Pro

1.0.0

NewInitial release

Sayan Variation Swatches for WooCommerce v1.0.7  ·  GPL-2.0  ·  WordPress.org  ·  Support forum