# Color swatches

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FhVgOBY7WHW1ZxLCPbwan%2FHelp%20Center%20(1).jpg?alt=media&#x26;token=da0189bb-6cbb-4d1e-9a52-083eb5cab5bd" alt=""><figcaption><p><a href="https://chromewebstore.google.com/detail/foxtransfer-html-to-shopi/babcinhpofjfhjjbcnjhoikcjbgebimb?utm_source=foxecom&#x26;utm_medium=helpcenter&#x26;utm_campaign=foxtransfer_launch">Install FoxTransfer Chrome Extension FREE here</a></p></figcaption></figure>

{% embed url="<https://youtu.be/AHbJJbYlfkk>" %}
:sparkles: This tutorial is applied for Zest version 8.3.0 and older :sparkles:
{% endembed %}

By displaying color swatches on your variant picker, you allow customers to quickly view and select the available color options. This creates a more intuitive and engaging shopping experience, as customers can immediately see how each color looks and feels in context with the product.

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2Fs8LLNEeqKv0elgWUQCmH%2Fimage.png?alt=media&#x26;token=97917ef2-009c-4eda-8385-f442a952b218" alt=""><figcaption><p>Source: <a href="https://themes.shopify.com/themes/zest/styles/flairy/preview">Demo Flairy</a></p></figcaption></figure>

## How to enable Color swatches

{% hint style="success" %}
Steps

1. In the theme editor (**Customize**), click **Theme settings**
2. Locate **Color swatches**
3. Make necessary changes
4. **Save**
   {% endhint %}

You can enable/disable color swatches by ticking/unticking the checkbox:

![](https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2F8wKhKIqOY8colIYlP3Fz%2Fimage.png?alt=media\&token=eb3c1f48-1faa-43d3-a7ac-352c1d26af1e)

{% hint style="warning" %}
To enable swatches, your **Picker type** must be **Buttons**.

👉 The picker type of each feature can be set in the feature settings.

* [product-information](https://docs.foxecom.com/zest-theme/collections-and-products/product-page/product-information "mention")
* [featured-product](https://docs.foxecom.com/zest-theme/theme-sections/featured-product "mention")
* [product-quick-view](https://docs.foxecom.com/zest-theme/theme-settings/product-quick-view "mention")
  {% endhint %}

### Color swatch trigger

Define which is the color option by inserting your relevant product **Option names.** Separate them by a comma.

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2F7PlZthaAtAbsNw4hOWNt%2Fimage.png?alt=media&#x26;token=4dc0ee8c-9fa8-45e0-9add-5964935d6e21" alt=""><figcaption></figcaption></figure>

You can select the **Color swatch shape** as **Circle**/**Square**.

{% tabs %}
{% tab title="Circle" %}

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2Fr8BqO8Ww9mib90bMxIpk%2Fimage.png?alt=media&#x26;token=2463bf32-0769-4005-b98f-63cbb4dbdaea" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Square" %}

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FIo9RMuerkHeBWl5Q488g%2Fimage.png?alt=media&#x26;token=b6c5e92b-5520-4b4d-b813-fb505da7a5f5" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Variant picker

{% hint style="info" %}
Select the **Swatch style** you want for your Variant pickers:&#x20;

* [**Custom colors**](#custom-colors)
* [**Shopify swatches**](#shopify-swatches)
* [**Variant image**](#variant-image).

This applies wherever a variant can be selected.
{% endhint %}

You can choose the swatch styles for the product form (in the [Product page](https://docs.foxecom.com/zest-theme/collections-and-products/product-page/product-information#variant-picker), [Featured product](https://docs.foxecom.com/zest-theme/theme-sections/featured-product#variant-picker) section, and the [Quickview](https://docs.foxecom.com/zest-theme/theme-settings/product-quick-view)) and the [Product cards](https://docs.foxecom.com/zest-theme/theme-settings/product-card) separately.&#x20;

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FkVQFCDHaRmRub4ShqeIC%2Fimage.png?alt=media&#x26;token=05305639-db46-4ca2-800b-f2376c5dd7e8" alt=""><figcaption></figcaption></figure>

#### Custom colors

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FyYcK0SYA9skZKVlDpTkc%2Fimage.png?alt=media&#x26;token=ddf46691-e537-4346-8553-7f3bb9cb4528" alt=""><figcaption></figcaption></figure>

If you want to use Custom colors as your Swatch style, choose the suitable [HEX color](https://g.co/kgs/X6rdiB) codes and add them to the provided box.

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2F5N6VjwhitDp7E3405qiC%2Fimage.png?alt=media&#x26;token=baaf19bb-8cf3-4a25-92d4-cfc6cd8ddfce" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Note:

* Separate items with a comma.
* Write the color name from the product option and separate options with the color HEX value.
* All texts are in lowercase.
  {% endhint %}

{% hint style="info" %}

#### Custom images:&#x20;

Besides custom colors, you can also add color swatches to your product and collection pages using images:

1. Go to **Shopify admin** > **Content** > **Files.**
2. Click **Upload files.**
3. Naming your swatch files:

* **Orange** swatches would need to be named **orange.png** (capitals become lowercase).
* **Light blue** swatches would need to be named **light-blue.png** (capitals become lowercase, spaces and other special characters become hyphens).

Here are some sample images for color swatches: [light blue](https://cdn.shopify.com/s/files/1/0594/4190/5837/files/light-blue.png?v=1657771752),[ ](https://cdn.shopify.com/s/files/1/0594/4190/5837/files/orange.png?v=1657766980)[cyan](https://cdn.shopify.com/s/files/1/0594/4190/5837/files/cyan.png?v=1657766980).

🚨 **Note**: .jpg files will not be shown, you must use .png

\
👉 Watch [our tutorial](https://youtu.be/AHbJJbYlfkk?si=TXghR92CaG2g97fp\&t=82).
{% endhint %}

#### Shopify swatches

{% hint style="warning" %}
Shopify swatches for your color swatches is available from :star: **Zest version 8.4.0 and above** :star:

See [changelog](https://docs.foxecom.com/zest-theme/changelog "mention")
{% endhint %}

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FShNixIFgtfhVXXWW8m5Y%2Fimage.png?alt=media&#x26;token=d3a0100f-d47b-4fe6-b41b-064cdc8bf71a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Native Shopify swatches allow you to manage your swatches directly from Shopify admin.

Native color swatches leverage Shopify categories to work.

For more information on setting up native color swatches, please check the [Shopify documentation](https://help.shopify.com/en/manual/custom-data/metafields/category-metafields/using-category-metafields).
{% endhint %}

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FfB4Z2X9kHrxqdbW7KK69%2Fimage.png?alt=media&#x26;token=3e582a06-1457-4c77-ac81-74acc21a632a" alt=""><figcaption></figcaption></figure>

#### Variant image

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FUncAGFVtkTA7YBxqsp0y%2Fimage.png?alt=media&#x26;token=2f1be747-736d-4444-aa6e-9c9a9ed034ce" alt=""><figcaption></figcaption></figure>

If you select the Variant image as your Swatch style, make sure you have [associated your product variants with their images](https://help.shopify.com/manual/products/product-media/add-images-variants) in Shopify **Products** > **Variants**.

<figure><img src="https://1836495117-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOdebKCa6IK9qfbdvSKj0%2Fuploads%2FyeR5ffogeyrLFMbSaen1%2Fimage.png?alt=media&#x26;token=af790e9d-6f5d-4d17-8533-7167a4b43136" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foxecom.com/zest-theme/theme-settings/color-swatches.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
