WooCommerce · Explainer
What Are Variation Swatches for WooCommerce? Colour, Image and Button Options

Short answer
Variation swatches are clickable colour, image or button options that replace the default dropdown menus on WooCommerce variable products. Instead of choosing Blue from a list, shoppers click a blue circle or a picture of the item. WooCommerce uses dropdowns by default, so swatches are added with a plugin or a theme that supports them.
Key takeaways
- Swatches replace variation dropdowns with clickable choices.
- Common types are colour, image, label or button swatches.
- WooCommerce core uses dropdowns; swatches come from plugins or themes.
- Swatches are set per attribute term, such as each colour or size.
- Clear labels matter, since colour alone is not accessible to everyone.
What are variation swatches?
Variation swatches are visual buttons for product options, such as colour circles, product thumbnails or size buttons, that shoppers click instead of picking from dropdown menus on a variable product.
WooCommerce variable products let one product have several versions, such as sizes and colours, each with its own price, stock and image.
The WooCommerce documentation on variable products explains how attributes and variations are created.
By default, shoppers choose variations from dropdowns. Swatches make those choices faster and more visual.
Dropdowns work, but they hide the options until clicked, and shoppers cannot see colours at a glance.
Which types of swatches are there?
The common types are colour swatches, image swatches, label or button swatches, and radio-style options, each suited to different kinds of attributes.
| Swatch type | Looks like | Best for |
|---|---|---|
| Colour | Filled circles or squares | Colours with clear shades |
| Image | Small product or pattern images | Patterns, materials, prints |
| Label or button | Text in a box | Sizes, capacities, models |
| Radio | Text with a selector | Long option names |
Many stores mix types: colour swatches for colour and button swatches for size.
Pick the type that makes the difference between options obvious at a glance.
Image swatches are especially useful for patterns or textures, where a colour circle cannot show the real look.
Does WooCommerce include swatches?
Core WooCommerce shows variation options as dropdowns, so most stores add swatches with a dedicated plugin, while some store themes include built-in swatch support.
The free Variation Swatches for WooCommerce plugin is one widely used option on WordPress.org.
Check your theme's features before adding a plugin. Duplicate swatch features can clash.
Premium swatch plugins often add swatches on shop and category pages, tooltips and more styling options.
Compare features against your needs before paying. Many stores only need product page swatches, which free versions often cover.
How do you set up swatches?
Install a swatch plugin, go to Products > Attributes, set each attribute's type to colour, image or button, then edit each term to choose its colour or image.
Global attributes, created under Products > Attributes, work best with swatches because the colour or image is set once and reused across products.
Custom attributes added on a single product may need settings on that product instead.
Set the swatch shape and size in the plugin settings once, so every product looks consistent.
After setup, open a variable product on the front end and test every combination.
How do swatches change the product image?
When a shopper picks a variation that has its own image, WooCommerce switches the main product image, so give each colour variation a matching photo.
This feature is part of WooCommerce. Swatches only make selecting the variation easier.
Upload variation images at the same size and angle as the main photo, so switching between colours looks smooth.
What happens with out-of-stock options?
Many swatch plugins grey out, cross out or hide options that are out of stock or not available in the chosen combination, which saves shoppers from dead ends.
Choose the behaviour that suits your store. Crossing out shows the option exists, while hiding keeps the choices clean.
Make the out-of-stock style clearly different from the selected style, so shoppers never think an unavailable option is chosen.
WooCommerce needs to know every variation for this to work. Very large variable products may load availability more slowly.
Our guide on exporting WooCommerce products helps check variation stock in bulk.
Do swatches help sales?
They can make choosing options quicker and clearer, especially on mobile, but results depend on your products, so watch add-to-cart rates after adding them.
Visual options reduce mistakes, such as picking the wrong colour from a list of similar names.
Fewer wrong orders also means fewer returns and support emails, which saves time for small teams.
Showing available colours on category pages can also help shoppers find the right product sooner.
Our guide on editing WooCommerce category pages covers other ways to improve product lists.
Are swatches accessible?
Only if they are built well: colour alone should never be the only cue, so swatches need text labels or tooltips, keyboard support and clear selected states.
The W3C explains why information should not rely on colour alone.
Show the selected option's name near the swatches, such as Colour: Navy.
Keep swatches large enough to tap on phones. Tiny circles are hard to hit with a finger.
Test swatches with a keyboard and a screen reader, or ask the plugin developer about accessibility support.
Do swatches slow down product pages?
Well-built swatch plugins add little weight, but image swatches and very large variation sets can add requests and data, so keep swatch images small.
Compress swatch images. They display tiny, so large files waste bandwidth.
Colour swatches cost almost nothing to load, because they are drawn with CSS rather than images.
Google's guide to image performance covers sizing and compression basics.
Avoid installing several plugins that each add variation features.
How do swatches work with page builders and block themes?
Most swatch plugins replace the variation selector wherever WooCommerce outputs it, including block themes and many builders, but custom product templates may need testing.
If swatches do not appear, check whether your template uses the standard add-to-cart block or widget.
Quick view pop-ups and product grids from other plugins may also need their own swatch support. Test them separately.
Our guide on customizing WooCommerce pages explains product templates in block themes.
Clear caches after enabling swatches, since cached product pages may still show dropdowns.
What are best practices for swatches?
Use consistent shapes and sizes, accurate colours, clear labels, real product photos for image swatches, and keep the number of options manageable.
Check colours on a phone screen. Some shades look similar on small displays.
Name colours in plain words. Navy is clearer than an internal code.
If a product has dozens of options, consider splitting it into separate products for easier browsing.
When should you skip swatches?
Skip them for products with very many options, technical choices that need explanation, or attributes where a simple dropdown is clearer.
Dropdowns still work well for long lists, such as lengths in fine steps.
You can mix both on one product, using swatches for colour and a dropdown for a long size list.
For a new store, start with dropdowns and add swatches once you know which attributes customers struggle with.
Our guide on building a WooCommerce website covers the other basics to get right first.
Frequently asked questions
What are variation swatches in WooCommerce?
They are clickable colour, image or button options that replace the default dropdown menus for choosing a variable product's size, colour or other attributes.
Does WooCommerce have swatches built in?
No. Core WooCommerce uses dropdown menus for variations. Swatches come from dedicated plugins or from store themes that include their own swatch features.
How do I add colour swatches in WooCommerce?
Install a swatch plugin, set the attribute type to colour under Products, then Attributes, and choose a colour for each term, such as Red or Navy.
Can swatches show on the shop page?
Some swatch plugins, often in premium versions, can show swatches on shop and category pages so shoppers see available colours before opening a product.
Are variation swatches good for SEO?
They do not directly affect rankings. They mainly improve the shopping experience, which can help engagement and conversions on product pages.
Sources
- Variable Products WooCommerce Docs
- Variation Swatches for WooCommerce WordPress.org Plugins
- Understanding Use of Color W3C WAI
- Fast load times web.dev
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


