> 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/product-options/20-option-types/swatch-and-button/button.md).

# Button

✨ [Demo store](https://optis-product-options-variant.myshopify.com/products/button?variant=51025989140758)

### 1. How Does the Button Display?

The Button option displays as a group of clickable buttons that users can select with a single click. Each value appears as a button, making it easy to visualize and choose. This layout is ideal for selections like size, material, or service add-ons.

Example of how it appears on a product page:

* A product with Button options for choosing “Small”, “Medium”, or “Large”.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fwty5T0G4B7Wk9GDG6FKA%2F38.png?alt=media&amp;token=d0360662-fd7f-42d5-8d2d-555f1e3c673e" alt=""><figcaption></figcaption></figure>

### 2. How to Create a Button

**Step 1: Add a New Option**

* Open **1. Add options**, click **Add option**, tick **Button** under **Swatch** on the **New options** tab, then click **Add options**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fq0JHxQMeQsVFN6tYAqyi%2F39.png?alt=media&amp;token=eba31b6e-6492-4070-a2dd-3f39f7f19c37" alt=""><figcaption></figcaption></figure>

**Step 2: Add information to the Button**

* Enter an option name for the Button (e.g., "Select Size")
* Add the option values (e.g., Small, Medium, Large).
* Tick on “Required field” if you want customers must choose the option before checking out.
* Tick on "Hide option label” if you don’t want to show the option name above the option values.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FxCFM4wbu9GRu2znIZmqZ%2F40.png?alt=media&amp;token=c08ae7d8-6161-4040-9d91-a241635413ad" alt=""><figcaption></figcaption></figure>

Other features:

* Price add-on > Extra fee – [What is it & How to Use](https://www.youtube.com/watch?v=5Bq4t0IrVEU)
* Price add-on > Upsell product – [What is it & How to Use](/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value.md)
* SKU – [What is it & How to Use](https://www.shopify.com/ca/retail/what-is-a-sku-number)
* Quantity – [What is it & How to Use](/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options.md)

**Step 3: Advanced Settings (If Needed)**

{% hint style="success" %}
**Visibility:** Enable visibility (conditional logic) if you want the Button to show/hide only when a customer selects a specific option from another field. [How to set up Conditional logic?](/product-options/advanced-setup/other-popular-features/how-to-set-up-conditional-logics.md)
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Ft2A7k37e2mmRlxZkpLSo%2F5.png?alt=media&amp;token=c1f9c719-0740-4af1-a5c9-cded14f09453" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Help text:** Add a short description to explain the purpose of the Button option. It can be displayed as Tooltips or Content (Below/Beside the option title, Below the option).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FTTd0Z02tyJJgBCQqIle2%2F9.png?alt=media&amp;token=3f4c410a-1b59-48ea-b53a-d606ebed96fd" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Default value:** Pre-select the Button options every time the customer goes to the site. It can save time for customers by providing common or expected choices.
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F06FDxIz0XqvQZEGVeco8%2F42.png?alt=media&amp;token=82ca0f92-4677-4211-b9c6-034438f983c8" alt=""><figcaption></figcaption></figure>

Example: You want the option value “S” on Size to be selected automatically when customers enter the product page. How it looks like in your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FIZMV8esq3Tp77ioAWvGZ%2FScreenshot%20-%202026-01-13T141806.991.png?alt=media&amp;token=06b1c508-738b-4968-8f6a-f6567c4b0c8a" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Quantity:** Lets customers choose how many units of each value they want. Turn on the **Quantity** column for the values that need it (use **Columns** in the **Option values** table), then set **Min quantity** and **Max quantity** to limit the total quantity across all values. Learn more in [How to use the Quantity feature](/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options.md).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FdU4vmT697Hzw2PJUTw0g%2F12.png?alt=media&amp;token=7c1647cc-be91-4bc0-997b-62a9062960a7" alt=""><figcaption></figcaption></figure>

**Step 4: Save and Test**

* Click Save to apply the settings.
* Visit the product page on your store to check if the Button option works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FrBY9qiZl3wM9SPxFQkoD%2F41.png?alt=media&amp;token=85f64d18-4950-4526-b09f-677b0ba3159c" alt=""><figcaption></figcaption></figure>

### 3. Real-World Applications of Button

* Sizes: Small, Medium, Large
* Materials: Leather, Canvas, Suede
* Extras: Add Dust Bag, Add Gift Note
* Customization: Choose Frame Color, Add Logo, Pick Layout

### 4. Key Features of Button

* The Button let users choose only one option from a predefined list, ensuring clear, exclusive selections. When displaying many option values, they can be arranged in a single line or inline layout to save space and maintain a clean, organized design.<br>

  <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfaumUqLADSmK0Dz5vBSECq1h2pylBaPpzn9k-QoYV4q6UQOJVxZEVuQXKIK4_JDF7AbJpb8xzqxOMlGy_v0xGXi2m7WoX1Iu30tn_aJjjIFSD5iKr6t3t9wdc-y60jq-W5KhpMNQ?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>
