> For the complete documentation index, see [llms.txt](https://docs.optis.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.optis.me/swatch/variant-display/pill-swatch.md).

# Pill swatch

{% hint style="success" %}
**Available on:** Product page only
{% endhint %}

✨Demo product: [Pill swatch](https://optis-color-swatch-variant.myshopify.com/products/pill-swatch?variant=45492608925833) (password: 1)

### **Function**

Displays each variant as a **rounded pill** with a **small preview (image or color)**, the **option value**, and the **price (optional)** in a single horizontal layout — a clean selector that's still slightly visual.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FHcBhYLJ9m6i38gmUDZj3%2Fimage.png?alt=media&amp;token=87ec5e91-0d79-4537-80aa-47d8c7b93f6d" alt=""><figcaption></figcaption></figure>

### **How it works**

* Each value appears as a **rounded pill button**.
* A **small thumbnail** (image or color swatch) sits on the left.
* The **option value** (e.g. Black, Blue, Brown) is shown next to it, with the selected pill highlighted.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F3FVwxcOzm2rqCyttF6iT%2Fimage.png?alt=media&amp;token=c0ac4f15-a406-42a1-aef1-5e33929b1bb7" alt=""><figcaption></figcaption></figure>

* The thumbnail comes from one of two **sources** you choose: [Auto image swatch](https://docs.optis.me/swatch/variant-display/auto-image-swatch.md) or [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md).

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FpL1ULjRLy1NxqYF9ULs9%2Fimage.png?alt=media&amp;token=34890f7b-07a6-4e91-b614-e013c2f7fa09" alt=""><figcaption></figcaption></figure>

### **Use when**

* You want a **clean but still slightly visual** variant selector.
* Variants have **simple differences** but still benefit from a small preview.
* You'd like to show the **value name (and price)** next to the swatch, but more compact than a [Swatch card](https://docs.optis.me/swatch/variant-display/swatch-card.md).

***

## How to use Pill swatch

{% stepper %}
{% step %}

#### Choose the display type to Pill swatch → Click Save

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FHEQYFMyGTuiacjUdvfmK%2Fimage.png?alt=media&amp;token=23aa2206-66cc-40b9-b2d5-a92a8baffc1f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Open the editor (pencil icon) and choose the swatch source

Click the **pencil / edit icon** next to the display type. At the top of the editor, use the **source** dropdown:

* [**Auto image swatch**](https://docs.optis.me/swatch/variant-display/auto-image-swatch.md) → uses the variant images already set in your Shopify product. No per-value setup needed.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-ef5f3d6123f6de1600316c53756bb3570c3d462f%2Fpill-swatch-source-auto-image.png?alt=media" alt="Pill swatch using the Auto image swatch source"><figcaption></figcaption></figure>

* [**Custom swatch**](https://docs.optis.me/swatch/variant-display/custom-swatch.md) → set each value by hand: upload your own images, or use solid colors / two-color splits (hex codes), with a live preview per value.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-93464fc763067daff4883bb2ddcba5f6a721e985%2Fpill-swatch-source-custom.png?alt=media" alt="Pill swatch using the Custom swatch source"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click Save to apply changes

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F8le5kfmEdk07A7M0aYpG%2Fimage.png?alt=media&amp;token=0fb81f63-13f3-4d0e-ba11-06c992b6ad99" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
On the **Custom swatch** source you can also use **✨ Auto-assign swatch**, **Bulk update**, and override a product's swatch individually — exactly as in [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md).
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FOlTJ6DBVLpptxsDBjax3%2Fimage.png?alt=media&amp;token=79e20be1-2a28-4222-ad48-0112335e2893" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Show price**, the **thumbnail size**, and the pill's **text, padding, and colors** are configured in [Styling](https://docs.optis.me/swatch/styling/styling-overview.md) — not in this editor.
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FVcOHUeeLF3P0hz3IOYCS%2FScreenshot%20(1).png?alt=media&amp;token=c67693dd-9e8b-4ee2-992a-5b185c67e64f" alt=""><figcaption></figcaption></figure>

***

## How it looks on your store

* **Product page:**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-7f1a97a2bdfc055eae0977136743d1bad8de6a3b%2Fpill-swatch-product-page.png?alt=media" alt="Pill swatch on the product page"><figcaption></figcaption></figure>

### Related

* [🧩 Swatch card](https://docs.optis.me/swatch/variant-display/swatch-card.md) — a larger card layout with the same two sources
* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md) / [🖼️ Auto image swatch](https://docs.optis.me/swatch/variant-display/auto-image-swatch.md) — the two sources
* [Styling settings reference](https://docs.optis.me/swatch/styling/styling-settings-reference.md) — show price, thumbnail size, colors
