My swatches do not show
Check, in this order:
- Show swatches on product pages is ticked on WooCommerce → Variation Swatches.
- The attribute is set to Color, Image or Label swatches — not Dropdown (no swatches), which is every attribute's default.
- The attribute is a global attribute (Products → Attributes). An attribute added on the product itself as a custom attribute has no terms, so it keeps the dropdown.
- The product is a variable product, and the attribute is Used for variations.
- On a block theme, the Single Product template uses the Add to Cart Form block. The newer Add to Cart + Options block draws its own selector without dropdowns, and there is nothing for swatches to decorate.
My colour swatches show the option name instead of a colour
The term has no colour saved, so the swatch falls back to a label. Edit the term under Products → Attributes → Configure terms and set Swatch color. The same happens for an image swatch whose image is missing or was deleted from the media library.
I cannot find the swatch fields on a term
They appear only on terms of attributes set to a swatch type. Choose the type on WooCommerce → Variation Swatches first, then edit the term. You also need the manage_product_terms capability to save them.
Every option of an attribute turned white
A term of a colour attribute saved without choosing a colour is stored as white (#ffffff), because the browser's colour picker always sends a value. Edit each term and set its real colour.
The dropdown shows as well as the swatches
The dropdown is hidden by the plugin's script once it has wired the swatches. If both are visible, the script did not run: check the browser console for a JavaScript error from another plugin, and check that a script-optimisation plugin is not delaying or excluding the plugin's script. Shopping still works, through the dropdown.
Does it work with page caching?
Yes. The product page markup is the same for every visitor, the swatches are server-rendered, and the script only reads the dropdown on the page. The full edition's archive swatches are plain links, so cached shop pages are fine too.
Does it work with HPOS and the Cart and Checkout blocks?
Yes. Both editions declare compatibility. The plugin never touches orders, the cart or the checkout — it only changes how options are chosen on the product page.
Can I have swatches on the shop page?
In the Full edition: tick Show swatches on shop and category pages. Each variable product shows its first swatch attribute as a row of links, up to five plus a +N counter. Clicking one opens the product with that option chosen. The free edition draws swatches on product pages.
Can I hide unavailable options instead of fading them?
In the Full edition: When an option is unavailable → Hide it. The free edition fades them out.
Does it send data anywhere?
No. Neither edition makes any external request.
I moved from the free edition to the full edition. Is my setup kept?
The colours, images and labels on your terms are kept — both editions use the same term meta (gmvs_color, gmvs_image_id, gmvs_label).
The per-attribute swatch type is not carried over: the free edition stores it in gmvsf_settings, the full edition in gmvs_attribute_types. After activating the full edition, set each attribute's type once on its WooCommerce → Variation Swatches screen. The free edition stands down by itself while the full edition is active.
What does uninstalling remove?
- Free edition: its own option,
gmvsf_settings. The term colours, images and labels are removed only if the full edition has never been configured on the site; otherwise they are kept for it. - Full edition:
gmvs_settings,gmvs_attribute_types, the licence stategmvs_license, the cached update payload, the licence-check cron event and the term colours, images and labels — unless the free edition is installed on the site, in which case the term colours, images and labels are kept, because the free edition reads them.
Neither edition writes anything to products, variations or orders.
