FAQ
Does it require WooCommerce?
Section titled “Does it require WooCommerce?”Yes. Swatch extends WooCommerce’s variable products and does nothing without it active.
What swatch types are available?
Section titled “What swatch types are available?”Two: colour dots and button / label pills. You pick the type per attribute, with a store-wide default for new attributes.
What happens to attributes I have not configured?
Section titled “What happens to attributes I have not configured?”They keep WooCommerce’s standard dropdown. A colour attribute with no colours set also falls back to the dropdown automatically, so a half-configured attribute never breaks the page.
Does it work without jQuery?
Section titled “Does it work without jQuery?”Yes. The front-end is vanilla JavaScript that hooks WooCommerce’s own variation events. Price, stock and the add-to-cart button update exactly as they do with the stock dropdowns.
Are the swatches accessible?
Section titled “Are the swatches accessible?”Yes. Each attribute’s swatches form a radiogroup with arrow-key navigation, visible focus rings and the term name as an accessible label. Tooltips are an extra for sighted users; screen-reader users always get the term name.
How is the colour stored?
Section titled “How is the colour stored?”Per term, as term meta, sanitised on save with sanitize_hex_color. The custom label is also stored as term meta.
Can I change the swatch size and shape?
Section titled “Can I change the swatch size and shape?”Yes, on the WooCommerce → Swatch settings page. Size and shape drive CSS custom properties, so swatches scale without layout shift, and you can re-theme them further from your theme stylesheet.
Will swatches show in the shop or category listings?
Section titled “Will swatches show in the shop or category listings?”The free edition renders swatches on the single product page. Swatches in shop/archive loops, per-variation images and image swatches are planned for Swatch PRO.
Does it cause layout shift?
Section titled “Does it cause layout shift?”No. The swatches reserve their space up front and the design respects prefers-reduced-motion, so there is no jump as the page settles.