Display variations with (P) Swatches element


In this article, you’ll learn about all the settings and how-to-use of the (P) Swatches element.



Important note: The (P) Swatches element is a child element of the Product module, meaning it will only function when nested inside a Product module.


The (P) Swatches element provides another way to display your products’ variations, alongside the (P) Variants element.

Before we start, make sure your products have different variants to show. Check out this Shopify article to learn how to add variants to your product.


Add (P) Swatches elements to your page

Step 1: In the GemPages Dashboard, enter the Editor by clicking “Edit” on one of your pages.

Step 2: If you don't have a Product module, drag and drop one onto your page.

Step 3: Drag and drop a (P) Swatches element inside a Product module.

After that, the element’s configurations will be shown to you on the left sidebar, which will be explained in the next section.


Configure the Settings tab

Swatch Rules

The Swatch Rules section allows you to set the swatch background using an image or a color.

Click the “Open Manager” button to view the Swatches Background Manager panel. 

The Current section shows your available variants for the current product select in the Product module, while the Others section displays all variants available in your store.

Click on a variant and toggle on background settings. From here, you can set its background manually. See the example below.



Show Label

The Show label switch is used to show/hide swatches’ labels. Toggle the switch on to show swatch labels and toggling it off does the opposite.

When toggled on, you’ll see the “More settings” button available. Click to expand the Show Label panel, where you’ll get access to more granular controls over the Bottom margin, Font, Font size, Line height, and Color for labels.



Swatch Text

The Swatch Text switch allows you to show/hide texts inside the swatches.

When the switch is off, you will be able to choose specifically which swatch you would like to remove text from.



When toggled on, you will have a “More settings” button to access the Swatch Text panel. In here, you can adjust the Font, Font size, and Color.



Selected Swatch

This section allows you to show/hide the border for a swatch when customers click on it. You can choose to have it on or off by toggling the switch.

If toggled on, you will see more settings to adjust the Border size and Border color.



Adjust the width and height of variant attributes. The Swatch Width value could be adjusted in pixels (px) or percentages (%), by default it will be set to auto.




Adjust the spacing between variants.


Align the element in three positions: Left, Center, or Right.


You can click on the small desktop icon at the top right corner of the section to quickly switch between the 4 responsive views: Desktop, Laptop, Tablet, and Mobile.


Sold Out Mark

When toggled on, you’ll be able to display the Sold Out mark when your product is sold out, and the Mark Color option in here allows you to tweak the color for the mark.

Here's an example with a product that is out-of-stock:



Extra Class

For the coders out there, you can further customize the (P) Swatches element’s content by adding a class name into this field and then point to it later in your CSS file.


The Desing Tab

Also don’t forget to further customize your (P) Swatches appearance with the Design tab.

After editing, please hit “Save” and “Publish” to make your changes go live.


That is literally it! Displaying swatches with GemPages requires absolutely no coding, only if you want to.

For more guides and tutorials, check out our Help Center and if you need any assistance, please contact our GemPages Support Team via email or live chat.


Was this helpful?