> 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/button.md).

# Button

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

✨Demo product: [Button](https://optis-color-swatch-variant.myshopify.com/products/button?_pos=1&_psq=button&_ss=e&_v=1.0) (password: 1)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-44d9a4670e1d598852646bc35c951abe6eb8ef53%2Fbutton-hero.png?alt=media" alt="Button variant selector on a product"><figcaption></figcaption></figure>

### **Function**

Displays each option value as a **clickable text button**, letting customers pick a value quickly without images or a dropdown.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FLHQPtaoenZ4TKcEPcHdS%2Fimage.png?alt=media&amp;token=d219f9a3-99a3-45e6-bb5e-15ff65974166" alt=""><figcaption></figcaption></figure>

### **How it works**

* Each value appears as a **button with text** (e.g. S, M, L).
* The selected button is **visually highlighted**.
* No image or color is used — this is a **text-only** selector, so there's no swatch editor to set up.

### **Use when**

* Options are **text-based** (e.g. Size, Material, Style).
* No image comparison is needed.
* You want a simple, compact selector that reads clearly at a glance.

***

## How to use Button

{% stepper %}
{% step %}

#### Change the display type to Button → Click Save

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fottmh5q7yMCc84mnvlXr%2FScreenshot%20(2).png?alt=media&amp;token=5d8268c1-cb9d-46d8-bac9-b5bad968596c" alt=""><figcaption></figcaption></figure>

In **Variants display**, set the option's **Product page display** (and/or **Collection page display**) to **Button**. There's nothing else to configure per value.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F6dZYeZIyU6ZZbJHeRP2C%2FScreenshot%20(3).png?alt=media&amp;token=9044d219-49eb-4ad8-94b2-8cc49a81d222" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### (Optional) Adjust the look in Styling

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FfYq86rAJ73d2pNOtXMcX%2FScreenshot%20(5).png?alt=media&amp;token=d7224471-affb-49b0-a1b4-e5860e287f3d" alt=""><figcaption></figcaption></figure>

Padding, spacing, text, border, and active/hover colors are configured in [Styling](https://docs.optis.me/swatch/styling/styling-overview.md).
{% endstep %}
{% endstepper %}

***

## Button without border

{% hint style="success" %}
**Available on:** Product page, Collection page · **Premium feature**
{% endhint %}

**Button without border** is a separate display type that works exactly like **Button** but **drops the button outline** for a cleaner, minimal look — the label sits directly on the page background, with the selected value still highlighted.

* Same **text-only** behavior as Button — no swatch editor to set up.
* It has its own **Styling** settings (independent of Button), so you can tune padding, text, and active/hover colors for the borderless look.
* This is a **premium** display type; if it's locked, it appears with a lock icon until your plan includes it.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FUoSGUY8ypL9b4l3WcK1X%2Fimage.png?alt=media&amp;token=6e5a3338-329d-4581-84f4-a5edc7add018" alt=""><figcaption></figcaption></figure>

**How to use:** in **Variants display**, set the option's display to **Button without border** → **Save**. Adjust the look in [Styling](https://docs.optis.me/swatch/styling/styling-overview.md).

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FcWhzfnrZiVMXvCuQC694%2Fimage.png?alt=media&amp;token=17a4f6dc-074e-4b2c-be10-531b26bbfd1c" 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-2b3543bf07c0767b5f8d69b1e1cd46acc6c40746%2Fbutton-product-page.png?alt=media" alt="Button variant selector on the product page"><figcaption></figcaption></figure>

* **Collection page:**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-2a23a47941ebe2506cc862585a7416cd29353ee5%2Fbutton-collection-page.png?alt=media" alt="Button variant selector on the collection page"><figcaption></figcaption></figure>

### Related

* [⬇️ Dropdown](https://docs.optis.me/swatch/variant-display/dropdown.md) — better when an option has many values
* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md) — when values need a color or image
* [Styling settings reference](https://docs.optis.me/swatch/styling/styling-settings-reference.md) — padding, colors, spacing
