# Swatches

Display your product variants as **Swatches** to make it easy for customers to view your product options at a glance.

<figure><img src="/files/xB0F4boaI704Xu4IWUnI" alt=""><figcaption></figcaption></figure>

<details>

<summary><mark style="color:blue;"><strong>Why are my swatches blank?</strong></mark></summary>

If your swatches appear blank, make sure that you are using an existing default color or that your image files and custom swatch names match your variant names. You may also need to add custom swatches for multiple languages.

</details>

## **Enable swatches**

***

Swatches are enabled in your theme settings by adding the option name for your variants.

1. Go to **Theme settings > Swatches**.
2. Enter the exact name of the product options that you want to display as swatches (e.g., 'Color'). Enter multiple option names as a comma-separated list.
3. Click **Save**.

<figure><img src="/files/57oquEftoFrC7tLFDu0E" alt=""><figcaption></figcaption></figure>

## Set up swatch colors

***

You can add swatches using **default colors** or **custom colors** added to your theme settings. You can also **upload custom images** to represent your product variants more precisely.

[Use default colors for swatches](/eclipse/products/swatches/use-default-colors.md)

[Use custom colors for swatches](/eclipse/products/swatches/use-custom-colors.md)

[Upload custom images for swatches](/eclipse/products/swatches/use-custom-images.md)

## Swatch options

***

Go to **Theme settings > Swatches** to change how swatches appear across your store.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Show product listing swatches</strong></td><td><a href="/pages/x01s1vsbkaTmrz5vMCTM#show-swatches">/pages/x01s1vsbkaTmrz5vMCTM#show-swatches</a></td></tr><tr><td><strong>Show product filter swatches</strong></td><td><a href="/pages/0vzTP0Stl3Zu9uSeRacx#show-product-filter-swatches">/pages/0vzTP0Stl3Zu9uSeRacx#show-product-filter-swatches</a></td></tr><tr><td><strong>Change product page swatch size</strong></td><td><a href="/pages/5TuK6lgxJb5c1H2WD2FA#swatches">/pages/5TuK6lgxJb5c1H2WD2FA#swatches</a></td></tr></tbody></table>


---

# 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://help.fluorescent.co/eclipse/products/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.