> For the complete documentation index, see [llms.txt](https://modutheme.gitbook.io/helix/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modutheme.gitbook.io/helix/theme-settings/swatches.md).

# Swatches

Swatches on the product page let customers pick a variant visually. These settings control how they look.

![Swatches setting panel](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-412ddbc8182ae70cc041d82a4440f5529e2721b6%2Ftheme-settings-swatches-panel.png?alt=media)

{% hint style="info" %}
These settings apply to swatches on the **product page**. Swatches on product cards in collection grids are configured separately under [Product Cards](/helix/theme-settings/product-cards.md) → Swatches.
{% endhint %}

***

## Swatch Style

Choose how variants are shown — Color, Variant image, Button, or Dropdown.

{% tabs %}
{% tab title="Color" %}
![Color swatch style](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-72a36f2b1d9a088a5b7ddf3cbb5a64a9c669c3e1%2Ftheme-settings-swatches-style-color.png?alt=media)

Filled color tiles.
{% endtab %}

{% tab title="Variant image" %}
![Variant image swatch style](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-4f18470712c945491039c8eed4dc248bafbb06d7%2Ftheme-settings-swatches-style-variant-image.png?alt=media)

Each variant's first product image as a thumbnail.
{% endtab %}

{% tab title="Button" %}
![Button swatch style](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-c0cf4233687383282f80f29b1d6ed0ebf23eaa29%2Ftheme-settings-swatches-style-button.png?alt=media)

Each variant as a text button.
{% endtab %}

{% tab title="Dropdown" %}
![Dropdown swatch style](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-69d49ebae85d1d79b10a599b52dc57ddde545fd3%2Ftheme-settings-swatches-style-dropdown.png?alt=media)

Variants in a collapsed select menu.
{% endtab %}
{% endtabs %}

***

## Appearance

Sets the swatch width, shape, and selected state.

* **Desktop width / Mobile width** — Swatch width on each screen size.
* **Height ratio** — Swatch shape, from square to a wide strip. Only available for Color swatches.
* **Selected style** — Mark the selected swatch with a **Border** (an outer ring) or an **Underline** (a line beneath).

***

{% hint style="info" icon="headset" %}
**Need help?**

Whether you have a question, run into an issue, or just need some guidance, our support team is here to help.

<a href="https://go.crisp.chat/chat/embed/?website_id=6c25581e-794a-41b4-8552-52f3de1dd1f7" class="button secondary" data-icon="comments">Chat with us</a> <a href="https://modutheme.ticksy.com" class="button primary" data-icon="ticket">Submit a ticket</a>
{% endhint %}
