# Swatches

***

**Swatches** are visual representations of product variants (e.g., colors), helping customers quickly understand and select options. They enhance the shopping experience by updating product images instantly and creating a more interactive, visually appealing interface.

### **I. How to Add Color Swatches (Using Category Metafields)**

**1. Step 1: Assign a Product Category**

In **Shopify admin**, assign a **category** that supports color metafields (e.g., *Apparel & Accessories → Clothing → Shirts*).

<figure><img src="https://1670075522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6M5ltDUBhmgWKXclaWBK%2Fuploads%2F5uX8dW8KYXiO8TrqQ4op%2FScreenshot%202026-03-31%20at%2012.00.20%E2%80%AFPM.png?alt=media&#x26;token=5d523924-2695-4e03-b522-ff816f519eee" alt=""><figcaption></figcaption></figure>

**2. Step 2: Connect Color Metafields**

Click the **dynamic source icon** (⛁) to link the **Color** field to the category metafield. You can add custom values via **Edit → Add new entry → Save**.

<figure><img src="https://1670075522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6M5ltDUBhmgWKXclaWBK%2Fuploads%2FpXRKAoWrX498IkNOSSfN%2FScreenshot%202026-03-31%20at%2012.03.56%E2%80%AFPM.png?alt=media&#x26;token=00b9b52e-3a7f-4822-b79c-35cde4c3d933" alt=""><figcaption></figcaption></figure>

**3. Step 3: Apply to Store**

Once configured, swatches will appear across product cards and product pages.\
Customize via: **Theme Editor → Theme settings → Swatches**

<figure><img src="https://1670075522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6M5ltDUBhmgWKXclaWBK%2Fuploads%2F7su9GEPZ0DLQFn5fuSof%2FScreenshot%202026-03-31%20at%2012.05.38%E2%80%AFPM.png?alt=media&#x26;token=63b914b1-e49c-413c-85e5-86d70e5a598a" alt=""><figcaption></figcaption></figure>

### **II. Swatch Settings in Theme**

**1. Swatch display options**

* **Show swatches:** Enable/disable swatches on **product cards** and **product pages**.
* **Swatch type:**
  * **Color**: Displays a color swatch for each variant.
  * **Native**: Uses the variant image (if available) instead of a color.
* **Product card swatch shape:** Defines the shape of swatches on collection grids: Square, Circle or Rectangle.
* **Hide swatches when only one option exists:** Automatically hides swatches if the product has only one variant.

**2. Product card settings**

* **Maximum swatches on product cards:** Limits the number of swatches displayed on product cards from 2 to 10 to maintain a clean layout.

<figure><img src="https://1670075522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6M5ltDUBhmgWKXclaWBK%2Fuploads%2FqC8OWMIjfhVkA8tq1vpf%2FScreenshot%202026-03-31%20at%2012.10.34%E2%80%AFPM.png?alt=media&#x26;token=3a8fedb6-33da-4876-9a60-1f14c3f7d03b" alt=""><figcaption></figcaption></figure>
