> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.weltpixel.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://help.weltpixel.com/en/article/how-to-make-sure-magento-2-pearl-theme-admin-option-changes-apply-in-storefront-j10aar/?bust=1758009853745)

* 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