How can I show product swatches on my category page?

To display product swatches on category pages, enable swatch visibility in the Pearl Theme settings.

Enable Swatches on Category Pages

Go to: Pearl Theme → Theme Options → Category Page → Swatch Options

• Display Swatches — Show swatches on products in category pages:

Options: No / Yes / On Hover

Set this to Yes (always visible) or On Hover to show swatches on category pages.

Additional Swatch Options

In Pearl Theme → Theme Options → Category Page → Swatch Options:

• Display Swatch Tooltip — Show a tooltip when hovering over swatches on category pages:

Options: Yes / No

In WeltPixel → Category Page → Item Swatch Options:

• Radius — Swatch border radius (px)
• Width — Swatch width (px)
• Height — Swatch height (px)
• Font Size — Swatch font size (px)
• Swatch Align — Alignment on category items (left / center)

If Changes Don’t Appear on the Storefront

• Follow this article for common causes and fixes:

How to make sure Magento 2 admin option changes apply in storefront

• If swatches still don’t show on Category Pages, check Product Pages:
• If swatches are missing on Product Pages too, it’s likely a product configuration or Magento swatch setup issue.

Notes on Magento Swatch Configuration

Pearl Theme uses Magento’s default swatch configuration. For setup guidance, see the official Magento documentation:

• Swatches:

https://docs.magento.com/m2/ce/user_guide/catalog/swatches.html

• Product Types (for attribute/product setup context):

https://docs.magento.com/m2/ce/user_guide/catalog/product-types.html

Updated on: 16/09/2025