Gatemi Variation Swatches Settings

There are two places to configure:

  1. WooCommerce → Variation Swatches — which attributes become swatches, and how they display. Needs manage_woocommerce.
  2. Products → Attributes → Configure terms → edit a term — each option's colour, image or label. Needs manage_product_terms.
The settings screen
The free edition’s settings screen.

Attributes

Every global attribute is listed with its taxonomy name (pa_colour) and a Shows as choice:

Choice Value Renders
Dropdown (no swatches) select WooCommerce's dropdown, untouched. The default.
Color swatches color A coloured chip per option
Image swatches image The term's image, thumbnail size
Label swatches label A button with the option's name or label

Where it is stored:

  • Free edition: inside gmvsf_settings, under types (['pa_colour' => 'color']).
  • Full edition: in its own option, gmvs_attribute_types.

These are different options, so after moving from the free edition to the full edition, choose each attribute's type once more on the full edition's screen. The colours, images and labels on your terms are shared and carry over unchanged.

An attribute with no terms used by a product, or a type that is not one of the four, falls back to the dropdown.

Display

Label Key Default Edition What it does
Show swatches on product pages enabled on (yes) Both The master switch. Off, every dropdown is left alone.
Show swatches on shop and category pages archive on (yes) Full edition Adds a swatch row under each variable product in the shop loop. Only works while the master switch is on.
Show the option name in a tooltip on hover tooltip on (yes) Full edition Adds the option name as a tooltip on product-page and archive swatches.

Free edition keys live in gmvsf_settings; full edition keys in gmvs_settings.

Appearance — Full edition

Label Key Choices Default
Swatch shape shape Square (square), Round (round) Square
Swatch size size Small, Medium, Large Medium
When an option is unavailable disabled_behavior Fade it out (fade), Hide it (hide) Fade it out

The free edition draws square, medium swatches and fades an unavailable option.

"Unavailable" means WooCommerce has disabled that option in its own dropdown, because no variation matches it with the choices already made. The swatch follows WooCommerce's decision; it never works it out itself.

The term fields

Open a term of an attribute set to a swatch type. Which fields appear depends on the type:

Field Shown for Term meta key Notes
Swatch color Color swatches gmvs_color A hex colour (#c0392b).
Choose swatch image / Remove image Image swatches gmvs_image_id A media library attachment id; drawn at thumbnail size.
Swatch label (optional — stands in for the term name) All three gmvs_label Text shown instead of the term name on a label swatch, or when a colour or image is missing.

The same three meta keys are used by both editions, so a term set up in one is read by the other.

Saving a term changes only the fields its type shows. Switching an attribute from colour to label and saving a term does not wipe the colour it had.

Note: the colour picker always submits a value. A term of a colour attribute that you save without touching the picker is stored as white (#ffffff).

When a swatch has nothing to draw

  • A colour swatch with no valid colour,
  • an image swatch with no image (or a deleted one),

falls back to a label chip showing the swatch label, or the term name if there is no label. You never get an empty square.

Shop and category pages — Full edition

With Show swatches on shop and category pages on, each variable product in the shop loop gets one row of swatches, printed after the product's loop item:

  • Only the first attribute of the product that is set to a swatch type is shown — one row per card.
  • At most 5 swatches are shown; the rest are summed up as +N. The number is filterable (gmvs_archive_limit).
  • Each swatch is a plain link to the product page with that option preselected (?attribute_pa_colour=red), which WooCommerce honours by itself. No JavaScript, so a page cache can serve the archive.

License & updates — Full edition

The card takes your gatemi.com licence key (GM-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX), shows its status and offers Deactivate on this site. An expired licence keeps the plugin working; it only stops updates. A check that could not reach gatemi.com never changes the status.

The full edition's screen also lists every filter it applies under For developers — see the Developer reference.

Shopping Cart
Scroll to Top