> This is part 1 of 2 of the full documentation (pages 1–100 of 142).
> The content is paginated: fetch every part to see all of it.
> Next part: https://docs.optis.me/llms-full.txt/1
> Page index: https://docs.optis.me/llms.txt

# General


# Refund Policy


# OPTIS Product Options

## | Overview

If you experience any issues while using the app, have concerns about billing, or need technical or development support, please contact us **before requesting a refund**. This policy applies specifically to the **OPTIS Product Options app**.

You can reach our support team via:

* 📧 **Email:** <support@optis.me>
* 💬 **In-app Live Chat**

Our team is committed to helping you resolve issues as quickly as possible:

* **Within 24 hours** on business days
* **Within 48–72 hours** on weekends

Refund requests will only be considered after we’ve had the chance to investigate and attempt to fix any issue related to the app.

***

## | Refund Terms

### **1. Refund Eligibility**

**Monthly subscription**

* Refund requests must be submitted within **5 days of the current billing cycle**
* Refunds are considered only if a **major issue** occurs (e.g. data loss or serious disruption caused by the app)

If you cancel the app after using it for several months:

* Usage will be calculated based on the **original monthly price (without discounts)**
* Refunds are handled **case by case**, after deducting Shopify’s processing fees

***

### **2. Non-Refundable Cases**

Since OPTIS Product Options offers a **free plan or trial period**, refunds are **not provided** in the following situations:

* You change your mind about using the app
* You purchased the app at a discount
* You installed the app for evaluation purposes
* You installed the app by mistake
* You lack the technical knowledge to use the app
* You request a goodwill refund
* You request refunds for previous billing cycles
* You request refunds for paid development or customization services
* Issues caused by conflicts with third-party apps or themes

We strongly recommend reviewing the app details, using the demo, or contacting us for clarification **before subscribing**.

***

### **3. How to Request a Refund**

If you would like to request a refund, please submit your request via **in-app Live Chat** or email us at **<support@optis.me>**.

If you encounter any issues while using the app, we strongly recommend contacting our support team first so we can investigate the problem and help restore any affected data.

Please **do not uninstall the OPTIS Product Options app** before reaching out. We’re only able to diagnose and assist while the app is still installed. Once the app is uninstalled, we won’t be able to investigate or provide support.

***

### **4. Before Uninstalling**

If you decide to uninstall **OPTIS Product Options**, please contact our support team first. We’ll help you remove any leftover code to ensure your store remains clean.

***

### **5. Refund Processing**

Once we receive your refund request:

* **Case 1: You’ve already been charged** → We’ll process the refund accordingly
* **Case 2: You haven’t been charged yet**\
  → Please wait until the charge appears, then contact us again\
  → Or contact **Shopify Support** directly to request charge cancellation

Due to Shopify’s billing system:

* All app billing and refunds are handled directly by **Shopify’s billing system**.
* As a result, we’re unable to cancel or prevent future charges on your behalf.
* Refunds can only be processed **after Shopify has completed billing for the current cycle**.

**Special Case – Forgot to Cancel After Trial**

If you forget to cancel your subscription after the trial period ends, you may be eligible for **50% refund of the first billing cycle**, as long as the request is submitted within the **first 5 days**.

***

## | **Charge Policy**

**App Upgrades, Downgrades, and Prorating**

When upgrading or downgrading your app plan, Shopify prompts you to approve a new recurring charge because only **one active charge** can exist per app at a time.

* The existing charge will be cancelled and replaced by the new one.
* Depending on the app, the new charge applies **immediately** or **after the current billing cycle** ends.

If the new charge applies immediately:

* **Upgrade:** You’ll be charged a prorated amount based on the difference in plan prices and the remaining days in your billing cycle. Example: If you upgrade from a $5 plan to a $15 plan on day 15 of a 30-day cycle, you’ll be charged:

  > $5 + ($15 – $5) × (15/30) = $10.
* **Downgrade:** You’ll receive an **application credit** for the unused portion of your higher plan, which can be applied to future Shopify app purchases.

***

If you have any questions or need clarification, feel free to **chat with us anytime** — our support team is always happy to help 💙


# OPTIS Color Swatch

## | Overview

This Refund Policy applies specifically to the **OPTIS Color Swatch** app.

If you experience any issues while using the app, have questions about billing, or need technical assistance, please contact our support team **before requesting a refund**. We’re always happy to help and will do our best to resolve your concerns as quickly as possible.

You can reach us via:

📧 **Email:** <support@optis.me>\
💬 **In-app Live Chat**

⏱ **Response time**

* Within **24 hours** on business days
* Within **48–72 hours** on weekends

Refund requests will only be considered after we’ve had the opportunity to investigate and attempt to resolve any issue related to the app.

#### 30-Day Refund Guarantee

We offer a **30-day money-back guarantee** for OPTIS Color Swatch.

If you’re not satisfied after your **first payment**, you can request a **full refund within 30 days** of that payment date.

Simply message us via in-app Live Chat or email **<support@optis.me>**, and we’ll process a full refund through Shopify once approved.

***

## | Refund Terms

### 1. Refund Eligibility

You are eligible for a **full refund** if:

* You’ve made your **first payment** for OPTIS Color Swatch
* Your refund request is submitted **within 30 days** of the first charge
* The issue is related to the app’s functionality, performance, or compatibility

Refunds are processed via Shopify’s billing system.

***

### 2. Non-Refundable Cases

Although we provide a generous refund guarantee, refunds may not be granted in the following cases:

* Refund requests submitted **after 30 days** from the first payment
* Requests for **previous billing cycles** beyond the first charge
* Paid development, customization, or setup services
* Issues caused by conflicts with third-party apps or custom themes
* Goodwill refund requests without technical or functional issues

We strongly recommend contacting our support team for clarification or assistance before making a purchase decision.

***

### 3. How to Request a Refund

To request a refund:

* Contact us via **in-app Live Chat**, or
* Email **<support@optis.me>**

If you encounter any issues, please reach out **before uninstalling the app**. We can only investigate and assist while OPTIS Color Swatch is still installed. Once the app is uninstalled, we may not be able to diagnose issues or recover data.

***

### 4. Refund Processing

Please note:

* All app billing and refunds are handled by **Shopify’s billing system**
* We **cannot cancel or prevent future charges directly**
* Refunds can only be issued **after Shopify completes billing for the current cycle**

If you haven’t been charged yet, please wait until the charge appears, then contact us, or reach out to Shopify Support directly.

***

If you have any questions or need help at any point, feel free to chat with us - our support team is always here to help 💙


# Privacy Policy

### 1. Introduction

BSS Commerce (“we”, “us”, or “our”) is a Shopify Partner. We develop Shopify apps (the “App”) and provide related support and consulting services (the “Services”) to merchants using Shopify to run their online stores.

This Privacy Policy explains:

* What information we collect when you install or use our app
* How we use and protect that information
* Your privacy rights and how the law protects you

By installing or using our app, you agree to the practices described in this policy.

***

### 2. Information We Collect

When you install the app, Shopify automatically shares certain information with us through Shopify’s API, in accordance with Shopify’s API License and Terms of Use.

#### Information from your Shopify store

This may include:

* Your store name
* Your store email address
* Customer email addresses
* Information shared when you contact us for technical or customer support

This information is required for the app to function properly and for us to provide support. If you choose not to provide this information, you may uninstall the app at any time.

#### Information from our website

When you visit the BSS Commerce website (“Site”), we may automatically collect certain information using common technologies such as:

* **Cookies** – small data files stored on your device to remember preferences and improve user experience
* **Log files** – including IP address, browser type, internet service provider, referring/exit pages, and timestamps
* **Web beacons, tags, and pixels** – used to understand how visitors browse the Site

For more details about cookies and how to disable them, please visit <http://www.allaboutcookies.org>.

***

### 3. Why We Collect Your Information

We use your information to:

* Create and save app settings for your store
* Provide technical support and respond to your requests
* Enable and operate app features
* Communicate with you about the app, updates, or related services
* Improve our products and user experience

***

### 4. Data Storage & Security

Your store and customer data are stored on BSS Commerce servers in the United States, hosted via **Linode**, and retained only while you use the app or until you uninstall it.

We take data protection seriously and use modern security measures to prevent unauthorized access, data loss, or misuse.\
However, please note that no method of online transmission or electronic storage is 100% secure.

***

### 5. Cookies Policy

Cookies help us improve your experience when using our website. We use the following types of cookies:

* **Strictly Necessary Cookies** – required for the website to function properly
* **Performance & Analytics Cookies** – help us understand how visitors use the site so we can improve it
* **Functionality Cookies** – remember your preferences and personalize content

You can control or disable cookies through your browser settings at any time.

***

### 6. Links to Other Websites

Our app or website may contain links to third-party websites. Please note that we do not control these sites and are not responsible for their content or privacy practices.

We recommend reviewing the privacy policies of any third-party websites you visit.

***

### 7. Your Privacy Rights

#### 7.1 European (GDPR) Privacy Rights

If you are located in the European Economic Area (EEA), you have the right to:

* Know what personal data we collect and why
* Access a copy of your personal data
* Correct or update inaccurate information
* Request deletion of your personal data (with some legal exceptions)
* Request data portability
* Object to or restrict certain types of processing
* Opt out of marketing communications
* Not be subject to automated decisions that significantly affect you

To exercise any of these rights, please contact us at **<support@optis.me>**.

***

#### 7.2 California Privacy Rights (CCPA)

If you are a California resident, you have the right to:

* Request details about the personal information we collect and how it is used
* Request deletion of your personal information
* Opt out of any sale of personal information (if applicable)
* Receive equal service and pricing even if you exercise your privacy rights

To submit a request, please email us at **<support@optis.me>**. We may need to verify your identity before processing your request.

***

#### 7.3 Nevada Privacy Rights

Nevada residents may request to opt out of the sale of personal information.\
Although we do not sell personal information, you may still submit a request by emailing **<support@optis.me>**.

***

### Contact Us

If you have any questions about this Privacy Policy or the data we collect, please contact us:

📧 **Email:** <support@optis.me>\
📍 **Address:**\
14-16-18-19F, Viwaseen Tower\
48 To Huu Street, Trung Van Ward\
Nam Tu Liem District, Hanoi, Viet Nam

Please clearly describe your request, especially if you are asking about the personal data we hold about you.


# OPTIS APPS


# Access and permission


# How to see the store's collaborator code?

## Why do we need partner access from your store?

— We need the temporary access to your store to help you with **settings** or **fix the problem** reported. We promise to be careful with every setting on your website. When we fix all problems, you can remove the access from your end.

## Steps to see the store collaborator code <a href="#id-1-3-steps-to-see-the-store-collaborator-code" id="id-1-3-steps-to-see-the-store-collaborator-code"></a>

### *Case 1 – Code located under Users > Security*

{% stepper %}
{% step %}
**In the navigation tab, go to Settings**

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/screenshot20_1l3r1gd.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**In the Settings, go to Users > Security, you will see the Collaborators Code**

<figure><img src="https://3535747775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1xnMNEsR61ChQe5QiQGn%2Fuploads%2FumP1qts8M8zAOurHqTcx%2Fimage.png?alt=media&amp;token=9e5eea1c-9864-418e-86a7-00c04d380571" alt=""><figcaption></figcaption></figure>

In this example, the Collaborator Request Code is **6443**
{% endstep %}
{% endstepper %}

### *Case 2 – Code located under Users and permissions*

{% stepper %}
{% step %}
**In the navigation tab, go to Settings**

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/screenshot20_1l3r1gd.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**In the Settings, go to Users and permissions**

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/screenshot-2025-08-11t13342547_1xrhypg.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Scroll down and your Collaborator Request Code will appear at the top of the page.**

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/screenshot-2025-08-11t13364714_nothbp.png" alt=""><figcaption></figcaption></figure>

In this example, the Collaborator Request Code is **2653**
{% endstep %}
{% endstepper %}


# How to approve our partner request?

We send the request to fix issue/do customization for you. Kindly let us know once you approve the request&#x20;

{% stepper %}
{% step %}

#### Click the notification icon on the upper right, you will see an alert notify that we sent you a collaborator request

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/1_15dmof.png" alt=""><figcaption></figcaption></figure>

🚩 If you don't see the notification, you can go to **Settings** in your Shopify admin

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/screenshot-2025-08-11t14211037_1y558j2.png" alt=""><figcaption></figcaption></figure>

Depending on your Shopify plan/interface:

* You may see **Users** → click it.
* Or you may see **Users and permissions** → click it instead
  {% endstep %}

{% step %}

#### **In the Users / Users and permissions section, you will see "**&#x4F;PTIS (by BSS Commerce) Suppor&#x74;**" request a collab access > Click on it**

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/thiet-ke-chua-co-ten_1isctwa.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### We already ticked the permissions we needed. So you just need to click "Accept request"

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/screenshot-2025-07-30t10442143_x6q82t.png" alt=""><figcaption></figcaption></figure>

To see the permissions we’re requesting:

* If you’re in **Users and permissions**, you’ll see the requested permissions listed directly.
* If you’re in **Users**, click **Edit permissions** to review them

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/screenshot-2025-07-30t10450997_1l4l3i1.png" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Kindly let us know once you approve the request ❤


# How to grant OPTIS team the access to specific permissions?

1. Firstly, you go to **Settings** > **Users and permissions** > **Collaborators > Search for "Tech Essence (by BSS Commerce) Support"**

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_cey3i2.png" alt=""><figcaption></figcaption></figure>

2. There are permissions we will need + location where you can find it:

* **View products**

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_dop3bt.png" alt=""><figcaption></figcaption></figure>

* **Themes > Edit code** (necessary)

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_13p40kf.png" alt=""><figcaption></figcaption></figure>

* **App** **permissions** > Manage and install apps and channels (necessary)

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_1cpezb3.png" alt=""><figcaption></figcaption></figure>

* **Store settings** > manage settings + shipping and delivery - For showing options on order confirmation & packing slips

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_1xfihcn.png" alt=""><figcaption></figcaption></figure>

You will also need to check if your email is verify or not. If not, you will need to verify so we can help showing options on order confirmation

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_i4moxg.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_4mm51f.png" alt=""><figcaption></figcaption></figure>

* **Order > View** - For options not showing on order cases

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_1iyf3ss.png" alt=""><figcaption></figcaption></figure>

3. After clicking on all permissions our customer support agent request, you will click **Save**. Then notify our agent&#x20;

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_1vgkogu.png" alt=""><figcaption></figcaption></figure>

<br>


# Verify email in Order Confirmation Email

To proceed with the installation for **Options on Order Confirmation Emails and Packing Slips**, we’ll need your email to be verified.

Here’s how you can do it:

1. Go to **Advanced Settings** in the app.
2. Click **Self-install (for dev)** under **Show options on Email confirm/   Packing slips**

   <figure><img src="https://3535747775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1xnMNEsR61ChQe5QiQGn%2Fuploads%2FuWHmeW74L4ueVSehQhn5%2Fimage.png?alt=media&amp;token=6afb4451-22f0-435d-b22c-32d56566cfdf" alt=""><figcaption></figcaption></figure>
3. Click the link **Order Confirmation Email Template**.

<figure><img src="https://3535747775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1xnMNEsR61ChQe5QiQGn%2Fuploads%2FBLYEfD9OY57NQKNPgHeV%2Fimage.png?alt=media&amp;token=7376fe6b-9aff-449a-811a-d97f3d34642e" alt=""><figcaption></figcaption></figure>

4. Select **Review and Verify** to complete the process.

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/screenshot-2024-12-30t14052635_11q8m3e.png" alt=""><figcaption></figcaption></figure>

Once this is done, let us know so we can continue assisting you with the installation.


# Our Services

At OPTIS, we focus on more than just providing apps - we’re here to support you throughout your journey, whenever you need us. No matter which OPTIS app you’re using, our team is always ready to help

### 🤝 Dedicated Support You Can Rely On

We provide ongoing support to ensure everything runs smoothly on your store.

Our team is available **24/7** to assist you with:

* General setup guidance
* Answering questions and clarifying how things work
* Investigating and resolving issues
* Helping you move forward when something doesn’t work as expected

You can reach us anytime via in-app Live Chat or email, and we’ll take it from there.

***

### ⚙️ Setup Assistance & Custom Requests

Every store is different, and we understand that sometimes you need more than a standard setup.

We’re happy to help with:

* Initial setup and configuration guidance
* Adjustments to better match your store’s workflow
* Custom requests based on your specific ideas or business needs

If you have something in mind even if it’s just an idea, feel free to share it with us. We’re always open to discussing what’s possible.

***

#### 💬 24/7 Support - Always here when you need us

Our support team is available **24/7**, so you can reach out anytime you need help.

You can contact us via:

* **In-app Live Chat**
* **Email:** [support@optis.me](https://mail.google.com/mail/?view=cm\&fs=1\&to=support@optis.me\&subject=OPTIS%20Support)

No matter your time zone, we aim to respond as quickly as possible and provide clear, practical solutions - not generic replies.

***

### 🤝 A Partner, Not Just a Support Team

We believe in long-term partnerships. Beyond fixing issues, we:

* Share suggestions to improve your setup and conversion flow
* Collect feedback and real merchant insights to improve the app
* Actively listen to your needs to shape future features

Your success with OPTIS matters to us.

***

### 🚀 Have an Idea or Need Help?

If you have any questions, ideas, or custom requirements, don’t hesitate to reach out.\
Just send us a message via live chat or email - we’re always happy to help.

💙 *Let us know what you’re trying to achieve, and we’ll help you get there.*


# Welcome to OPTIS Product Options Help Center!

Welcome! 😊\
OPTIS Product Options helps you create flexible, powerful product options beyond Shopify’s default variant limits, so you can sell customizable products without complicating your store.

Whether you sell personalized items, add-ons, or products with multiple choices, OPTIS is designed to keep your setup clean, fast, and easy to manage.

## 🎯What can OPTIS Product Options do?

OPTIS is built for merchants who need **flexible product options and personalization** without being limited by Shopify’s default variants.

It’s ideal if you want to:

* Offer custom product options like text input, image upload, swatches, sizes, fonts, or engraving
* Let customers preview their selections in real time before checkout
* Collect important customer inputs directly on the product page
* Increase AOV with add-ons such as gift wraps, bundles, and paid upgrades
* Create a clean buying flow using conditional logic and grouped options
* Manage variant-based images, pricing, and inventory more efficiently

OPTIS is easy to use, simple to manage, and integrates smoothly with Shopify discounts, themes, and checkout - with our support team available whenever you need help.

✨ View our demo store: [OPTIS demo store](https://optis-product-options-variant.myshopify.com/)

## 🚀 Where to start

* [Quickstart](https://docs.optis.me/product-options/getting-started/quickstart) - turn on OPTIS in your theme and create your first option set
* [20 option types](https://docs.optis.me/product-options/20-option-types/text-input) - text fields, lists, swatches, file upload, dates and more
* [Use option set templates](https://docs.optis.me/product-options/getting-started/use-option-set-templates) - start from ready-made option sets
* [Assign an option set to products and customers](https://docs.optis.me/product-options/getting-started/assign-option-sets-to-products-and-customers)
* [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features) - what is included in Free, Advanced, Platinum and Unlimited

## 💬Need help?

Our support team is always here to help including custom setup when possible.

* Live chat inside the app
* 📩 Email us at [support@optis.me](https://mail.google.com/mail/?view=cm\&fs=1\&to=support@optis.me\&subject=OPTIS%20Support)
* Fast, human replies (no bots 👀)


# Quickstart

This guide will help you set up OPTIS quickly and start adding custom options to your products.

## 1. Enable OPTIS Options on your theme

1. On the **Dashboard**, in the **Setup guide**, click **Add to theme** (step **Activate OPTIS Product Options**):

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FfODubGCV4HNB8myeQgAb%2Fadd%20to%20theme.png?alt=media&amp;token=3f5f19b3-1598-47bb-92e3-1bbbd426a543" alt=""><figcaption></figcaption></figure>

2. On the **Theme Customize** page, click **Save** to finish enabling the **App Embed**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FYCtnp7rTIw6FHTjsNCkM%2FScreenshot%20-%202026-01-12T112958.040.png?alt=media&amp;token=1ba0858c-ce19-4060-a58a-a59c0ffccd88" alt=""><figcaption></figcaption></figure>

3. Back in the app, click **Add app block** (step **Add OPTIS Product Options to your products**) to add the OPTIS Product Options block to your product page, then save the theme.

If the app embed is off, the Dashboard shows **Unable to display OPTIS options on your live store**. Click **Go to theme editor**, turn it on and save. See [Dashboard and setup guide](broken://pages/bW5qahIfrBDsWuWUp7z2).

## 2. Create an option set

We have a quick 2-minute video to help you create an option set + assign it to products:

{% embed url="<https://www.youtube.com/watch?t=&v=D2iqYn6wZDw>" %}

1. Go to **Option sets** and click **Create option set**, then choose **Create from scratch** (or **Use template** to start from a ready-made option set).
2. In **1. Add options**, click **Add option**, tick the option types you need (for example **Text box**, **Dropdown menu** or **Swatch**) and click **Add options**.
3. Click an option to set its label, values and settings. The **Preview** on the right shows how it looks.
4. Give the option set a name and make sure its status is **Live**.

Learn more: [Manage option sets](https://docs.optis.me/product-options/getting-started/manage-option-sets), [Use option set templates](https://docs.optis.me/product-options/getting-started/use-option-set-templates) and the [20 option types](https://docs.optis.me/product-options/20-option-types/text-input).

## 3. Apply option set to products

1. Go to **Option sets** and click the option set you want to apply to products:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FMeWrxFlJ9gS5UVGTneeY%2Fedit%20option%20set.png?alt=media&amp;token=bee55d5e-067c-4cf4-8c49-155ad0523f9a" alt=""><figcaption></figcaption></figure>

2. Open **2. Select products**, choose **Specific products** under **Apply option set to**, pick the products and click **Save**:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FjzE3NrKBU99t4AquRAEy%2Fapply%20to%20product.png?alt=media&amp;token=b0ec45b4-4396-4373-ae90-0494039e2e15" alt=""><figcaption></figcaption></figure>

Open one of the products on your store to check that the options show. If they do not, see [What to do if OPTIS Options aren’t showing on product pages?](https://docs.optis.me/product-options/getting-started/what-to-do-if-optis-options-arent-showing-on-product-pages)

## Next steps

* [Assign an option set to products and customers](https://docs.optis.me/product-options/getting-started/assign-option-sets-to-products-and-customers) - collections, tags, variants, exclusions and priority
* [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features)
* [Settings overview](https://docs.optis.me/product-options/customize-design/settings-overview) - match the options to your theme


# Plans and feature availability

OPTIS Product Options is free to install. You can start on the **Free** plan and upgrade only when you need more option types, features or limits. This page explains what each plan includes and how the Premium option set lets you try paid features on the Free plan.

To see or change your plan, open **Pricing plan** in the app's left menu.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FmCosRxPd5oMDvo9Dk3Rp%2Fimage.png?alt=media&amp;token=2dd9eb5c-6ef3-4889-a876-56369a5419ae" alt=""><figcaption></figcaption></figure>

## Plans at a glance

| Plan          | Price          | Best for                                                       |
| ------------- | -------------- | -------------------------------------------------------------- |
| **Free**      | $0 / month     | Getting started with basic product options                     |
| **Advanced**  | $9.99 / month  | All main option types with price add-ons and conditional logic |
| **Platinum**  | $19.99 / month | The full feature set, with live preview and option quantities  |
| **Unlimited** | $49.99 / month | Everything in Platinum plus dedicated support                  |

* **Free** includes 10 option sets, the 11 basic option types, Analytics, and email and live-chat support.
* **Advanced** includes everything in Free plus unlimited option sets, more option types, Price add-on, Conditional logic, default values, character/value/selection limits, up to 5 files per file upload, Import/Export, Translation and design Settings, and prioritized support.
* **Platinum** includes everything in Advanced plus all option types, up to 20 files per file upload, option quantity, Upsell product, Live mockup (product personalizer), editing options on the cart page and customer targeting.
* **Unlimited** includes everything in Platinum plus all future features and updates, theme integration, exclusive customization, expert optimization and top-priority support.

{% hint style="info" %}
Merchants on an older (legacy) plan can keep features that plan included. Open **Pricing plan** in the app to see exactly what your current plan includes.
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F7l0qMfhIafz1R1kbKAqt%2Fimage.png?alt=media&amp;token=740f23e5-f2b5-4e78-b5ba-2a2a9b3a0c0c" alt=""><figcaption></figcaption></figure>

## Feature availability by plan

| Feature                                                                                                               |           Free          |  Advanced |  Platinum | Unlimited |
| --------------------------------------------------------------------------------------------------------------------- | :---------------------: | :-------: | :-------: | :-------: |
| Number of option sets                                                                                                 |            10           | Unlimited | Unlimited | Unlimited |
| Text box, Text area, Number field, Checkbox, Dropdown menu, Radio button, Swatch, Button, Paragraph, Heading, Divider |            ✅            |     ✅     |     ✅     |     ✅     |
| File upload, Date & time, Color picker, Email, Font picker, Phone (Storefront V2), Option group                       | Premium option set only |     ✅     |     ✅     |     ✅     |
| Switch, Dropdown with thumbnail, Pop-up modal                                                                         | Premium option set only |     —     |     ✅     |     ✅     |
| Color and image values (swatches, thumbnails)                                                                         |            ✅            |     ✅     |     ✅     |     ✅     |
| Analytics                                                                                                             |            ✅            |     ✅     |     ✅     |     ✅     |
| Cart drawer / mini-cart support                                                                                       |            ✅            |     ✅     |     ✅     |     ✅     |
| Price add-on (**Extra fee**)                                                                                          | Premium option set only |     ✅     |     ✅     |     ✅     |
| Conditional logic (**Visibility**)                                                                                    | Premium option set only |     ✅     |     ✅     |     ✅     |
| SKU                                                                                                                   | Premium option set only |     ✅     |     ✅     |     ✅     |
| Default value, character limits, selection limits, search bar                                                         | Premium option set only |     ✅     |     ✅     |     ✅     |
| Show updated total price with add-ons                                                                                 | Premium option set only |     ✅     |     ✅     |     ✅     |
| Show options on order emails and packing slips                                                                        | Premium option set only |     ✅     |     ✅     |     ✅     |
| Import / Export option sets                                                                                           | Premium option set only |     ✅     |     ✅     |     ✅     |
| Settings (General, Design, Translation Texts)                                                                         |          Locked         |     ✅     |     ✅     |     ✅     |
| Files per File upload option                                                                                          |            —            |  Up to 5  |  Up to 20 |  Up to 20 |
| Maximum size per uploaded file                                                                                        |            —            |   20 MB   |   50 MB   |   50 MB   |
| Option quantity                                                                                                       | Premium option set only |     —     |     ✅     |     ✅     |
| Upsell product (link a Shopify variant's price and stock)                                                             | Premium option set only |     —     |     ✅     |     ✅     |
| Live mockup (product personalizer)                                                                                    | Premium option set only |     —     |     ✅     |     ✅     |
| Edit option on cart page                                                                                              | Premium option set only |     —     |     ✅     |     ✅     |
| Specific variants and option sets for variants                                                                        | Premium option set only |     —     |     ✅     |     ✅     |
| Customer targeting (**Select customers**)                                                                             | Premium option set only |     —     |     ✅     |     ✅     |

{% hint style="success" %}
When an option type or feature needs a higher plan, the editor shows an **Advanced** or **Platinum** badge next to it. Click the badge to go to the **Pricing plan** page.
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FeyM3050HRzNdu5mnnpvX%2Fimage.png?alt=media&amp;token=4925b644-c6d1-4b44-ba2a-5776b314341d" alt=""><figcaption></figcaption></figure>

## Try premium features on the Free plan (Premium option set)

On the Free plan you can use every Premium feature on **one product** without paying and without a time limit. To do this you use a **Premium option set**:

1. Go to **Option sets**.
2. Click **Create premium option set**, or click the **star** icon on the row of an existing option set and confirm **Set as premium**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FxfJZcv3A9tYqHTz1xUqJ%2Fimage.png?alt=media&amp;token=bbde1797-5163-4e49-a1ea-6bb95c701c1b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FfaAu3M579huVBqypSZpZ%2Fimage.png?alt=media&amp;token=327a2a72-55ab-4cc3-a7dc-42457f725ead" alt=""><figcaption></figcaption></figure>

3. Build your option set with any option type or feature.
4. In **2. Select products**, apply it to **one product** (or one variant) and save.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FtjB89vSqXD0ANVLn8Dam%2Fimage.png?alt=media&amp;token=12006095-d229-40a9-bba6-7b23c3f0c555" alt=""><figcaption></figcaption></figure>

### **Things to know:**

* You can have **one** Premium option set per store.
* A Premium option set can be applied to **one product or one variant only**. Options such as collections, tags, several products and product exclusions are not available for it.
* **Set as premium** makes a **copy** of the option set. The copy is not assigned to any product until you assign it.
* **Unset premium** turns the option set back into a regular option set. Its features then follow your current plan.
* If you upgrade to a paid plan, you can use Premium features in all option sets and on all products.

## Trial, billing and changing plans

* Every paid plan starts with a **14-day free trial** with full access to all features. You are not charged until the trial ends.
* Billing is handled by Shopify. Charges appear on your Shopify invoice, and invoices are in **Settings > Billing** of your Shopify admin.
* To change plan, open **Pricing plan**, choose a plan and click **Upgrade**, **Downgrade** or **Start 14-day free trial**. Upgrades and downgrades take effect immediately and the remaining balance of the current cycle is prorated automatically.
* Have a discount code? Enter it in the **Discount code** field on the **Pricing plan** page and click **Apply**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fqx7rtdBRjpJGioj5R32t%2Fimage.png?alt=media&amp;token=d01cc36d-9db3-4542-8229-d1550c253b0f" alt=""><figcaption></figcaption></figure>

* To cancel a paid plan, switch to the **Free** plan by clicking **Choose this plan** under Free. Access to paid features ends immediately.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FOYrLQa0FXX0QsjsITYHj%2Fimage.png?alt=media&amp;token=0dfd6c39-1eb3-47f3-86d1-dd7f36a0a450" alt=""><figcaption></figcaption></figure>

* Your settings and option sets are kept when you change plans. Features that need a higher plan become unavailable after a downgrade.

## Related guides

* [Quickstart](https://docs.optis.me/product-options/getting-started/quickstart)
* [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options)
* [How to Use "Upsell product"](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Manage option sets

The **Option sets** page lists all of your option sets. From here you can create, search, duplicate, activate, deactivate and delete option sets, and see which products they are applied to.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLzbrkLbB0rCe54qZnBRo%2FScreenshot%20(16).png?alt=media&amp;token=8a9e7b52-589d-4111-b752-fa760e2ba665" alt=""><figcaption></figcaption></figure>

## Create an option set

Click **Create option set** and choose:

* **Create from scratch** - start with an empty option set and add your own options.
* **Use template** - start from a ready-made template. See [Use option set templates](https://docs.optis.me/product-options/getting-started/use-option-set-templates).

You can also click **Create premium option set** to try all Premium features on one product (see [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features)), or **Import / Export** to create option sets from a CSV file (see [Export and Import Option Sets](https://docs.optis.me/product-options/advanced-setup/export-and-import-option-sets)).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F6yfB41K11z86f0WgZame%2FScreenshot%20(19).png?alt=media&amp;token=72201493-1c0f-422f-90ca-500f9e587fb7" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
The Free plan allows up to **10 option sets**. When you reach the limit, the app shows **You've reached the Free plan limit**. Click **Upgrade plan** to create more.
{% endhint %}

## Find an option set

* Type in **Search option sets or products** to find an option set by its name or by a product it is applied to.
* Use the tabs **All**, **Live** and **Inactive** to filter the list by status.
* Sort the list by **Option name** (A-Z or Z-A) or by **Updated** (newest or oldest first).

## Read the list

| Column         | What it shows                                                                                                                                   |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Option Set** | The name of the option set. An icon next to the name shows when the option set uses a feature that needs the **Advanced** or **Platinum** plan. |
| **Status**     | **Live** (shown on your storefront) or **Inactive**.                                                                                            |
| **Updated**    | When the option set was last changed.                                                                                                           |
| **Products**   | How many products it is applied to. Click it to open **Applied products**.                                                                      |
| **Actions**    | Shortcuts for the option set (see below).                                                                                                       |

Click the name of an option set to open the editor.

## Actions on one option set

In the **Actions** column:

* **Duplicate** - create a copy of the option set.
* **Save as template** - save the option set as one of your own templates, so you can reuse it. Give it a **Template name** and click **Save as template**.
* **Delete** - delete the option set after confirming.
* **Star** icon - set the option set as your Premium option set, or unset it. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).

## Actions on several option sets

Tick the option sets you want, then use the bulk actions menu:

* **Active option sets** - make them **Live**.
* **Deactivate option sets** - make them **Inactive**.
* **Duplicate option sets**
* **Delete option sets**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLPbZLtOFUEQOvwhZjhok%2FScreenshot%20(20).png?alt=media&amp;token=33e9dfc0-fa59-492f-adb2-ea445d9e7653" alt=""><figcaption></figcaption></figure>

See also [Active/Deactivate the option set](broken://pages/IArNw9aIL6fNoU6XN2kC) and [Change the option set name](broken://pages/h2eSIUjx6XIf1smJbMII).

## Applied products

Click the number in the **Products** column to open **Applied products**. It lists every product (or variant) the option set is applied to, with its status:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Faca02ca4J8IeCah1iGMk%2FScreenshot%20(23).png?alt=media&amp;token=cef08a43-5b68-45a4-ae6e-e93667558a08" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FwohJL1OJkqZ2ySEJ41Oc%2FScreenshot%20(24).png?alt=media&amp;token=77937e09-027c-41bf-8401-8f8a23883075" alt=""><figcaption></figcaption></figure>

* **Live** - customers see this option set on the product.
* **Inactive** - another live option set is currently applied to this product, so this one is not shown on it. See **Priority** in [Assign an option set to products and customers](https://docs.optis.me/product-options/getting-started/assign-option-sets-to-products-and-customers).

Use **Search products** to find a product and **View live product** to open it on your store. If the option set is not applied to anything yet, click **Select products** to choose products.

{% hint style="info" %}
Need help with design or setup? Use the chat button in the app or email <support@optis.me>.
{% endhint %}


# Use option set templates

Templates let you publish product options quickly, starting from option sets crafted by Shopify experts and optimized for a great customer experience and conversion. You can also save your own option sets as templates and reuse them.

Open **Templates** in the left menu of the app.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FNr6TOqK8GPXX87yezN12%2FScreenshot%20(48).png?alt=media&amp;token=478bb520-372b-44db-8bb2-0646e8909e2d" alt=""><figcaption></figcaption></figure>

## OPTIS templates

The **OPTIS templates** tab shows ready-made option sets as cards. Each card shows the template name and how many options it has (for example, "5 options").

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F242V5khyBvTHuss8oDVn%2FScreenshot%20(49).png?alt=media&amp;token=35056d7f-d38e-4386-b83f-21b1cb0cd09a" alt=""><figcaption></figcaption></figure>

* Use **Search templates** to find a template by name.
* Use the **Filter templates** button to filter by **Categories**. Click **Clear** to remove the filter.
* Click a card to see the **Template preview**. The preview shows the options on a sample product.
* Click **View demo** to see a live demo of the template.
* Click **Apply** to start a new option set from the template. The editor opens with the template's options already added. Change whatever you need, choose the products, and click **Save**.

## My templates

The **My templates** tab lists the templates you created, with the columns **Template**, **Updated** and **Actions**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fi6CKjo9rYwdLUWs536T6%2FScreenshot%20(50).png?alt=media&amp;token=ca4d2389-240b-4ba3-928c-97485c2acbf6" alt=""><figcaption></figcaption></figure>

* Click **Create template** to build a new template in the editor.
* Use **Edit**, **Delete** and **Apply** on a template row.
* Tick several templates to use **Duplicate templates** or **Delete templates**.

### Save an option set as a template

You can turn any option set into a template:

* On the **Option sets** page, click **Save as template** in the **Actions** column of the option set.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FO5wVV3NFqp2TZJPUwiXk%2FScreenshot%20(40).png?alt=media&amp;token=68e2dd3a-65ff-4132-bc0f-4cd1fcfc5b8b" alt=""><figcaption></figcaption></figure>

* Or, in the option set editor, open **More actions** and choose **Save as template**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FPrUEpKvLDZiYhhsZWIyc%2FScreenshot%20(41).png?alt=media&amp;token=0ca68a94-da59-4aab-bd1e-f6d2a021d332" alt=""><figcaption></figcaption></figure>

Enter a **Template name** and click **Save as template**. The template then appears in **My templates**.

## Use templates while you edit an option set

You can also add ready-made options to an option set you are editing:

1. In **1. Add options**, click **Add option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLaPhjXyr6LF8vkzb60Na%2FScreenshot%20(42).png?alt=media&amp;token=8e754e81-c188-4523-8d1c-27c28a9538a7" alt=""><figcaption></figcaption></figure>

2. In the **Add option** window, choose the **OPTIS templates** or **My templates** tab (the **New options** tab lists the option types).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fr0ZNVTojAsJHfBuf5K97%2FScreenshot%20(43).png?alt=media&amp;token=1c6aa239-b7f6-4c8d-a924-8b0f1caefd2c" alt=""><figcaption></figcaption></figure>

3. Search for a template, or use **Filter by option type**, then tick the templates you want and click **Add options**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fur7FNMiBQygBROY8Ml7i%2FScreenshot%20(45).png?alt=media&amp;token=071ffea1-e89d-41c6-820c-d24c01fc576b" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Note:**

* The template is designed to help you create an option set quickly. Once a template has been added to an option set, you’ll need to update that option set directly when making changes.
* Templates are mainly useful for creating multiple option sets that use the same options. However, changes made to the template will not automatically sync with option sets that have already been created from it.
  {% endhint %}


# Assign an option set to products and customers

After you add options to an option set, you choose **where** it appears (which products) and **for whom** (which customers). You do this in the second and third steps of the option set editor:

* **1. Add options**
* **2. Select products**
* **3. Select customers**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLh8vweIsF07APZ0ICRo7%2FScreenshot%20(26).png?alt=media&amp;token=5f30f81f-e46b-416e-867e-c7ad8060e6e4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
An option set only appears on your storefront when its status is **Live** and it is applied to a product. See [Active/Deactivate the option set](broken://pages/IArNw9aIL6fNoU6XN2kC).
{% endhint %}

## 2. Select products

Open **2. Select products**, and under **Apply option set to** choose one of the following:

| Choice                    | What it does                                                                                                                                                                                    |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **All products**          | Shows the option set on every product in your store.                                                                                                                                            |
| **Specific products**     | Shows the option set only on the products you pick.                                                                                                                                             |
| **Specific collections**  | Applies the option set automatically to the products in the collections you pick.                                                                                                               |
| **Specific product tags** | Applies the option set automatically to the products that have one of the tags you enter.                                                                                                       |
| **Specific variants**     | Shows the option set only for the variants you pick. For it to switch correctly when customers change variant, install [Option set for specific variants](broken://pages/2lM8EwXKsupvuSvXSJhi). |
| **Not assigned**          | Keeps the option set saved but does not show it on any product.                                                                                                                                 |

**Specific collections**, **Specific product tags** and **Specific variants** need the **Platinum** plan. On other plans they appear greyed out with the required plan next to the name. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F8Lvdh7FoRPfZ4SGefW0b%2FScreenshot%20(28).png?alt=media&amp;token=c77c9eeb-98db-4885-a9a0-65b23040f767" alt=""><figcaption></figcaption></figure>

If you click **Save** without choosing where to apply the option set, the app shows **No products selected**. Choose a product condition (or **Not assigned**) and save again.

### Exclude products

Under **Exclude products** you can keep the option set off some products even when it applies to many:

* **None** - do not exclude anything.
* **By product tag** - enter the tags to exclude. Products with any of these tags do not show the option set.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FcD2GOPw8s6coYXipXXeY%2FScreenshot%20(30).png?alt=media&amp;token=e16dc22d-6772-4445-a98b-1ba3e242e910" alt=""><figcaption></figcaption></figure>

### Priority

If several option sets apply to the same product, only one of them is live on that product. Use **Priority** (a number from 0 to 99) to decide which one: **the option set with the lower priority number is shown first.**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FBXVYDTdmNf9ALE5sWrTA%2FScreenshot%20(32).png?alt=media&amp;token=a6396721-a665-4da4-90c2-98475cfdf6b2" alt=""><figcaption></figcaption></figure>

In **Applied products** (open it from the **Products** column of the Option sets list), the option sets that are not used on a product show as **Inactive** for that product. See [Manage option sets](https://docs.optis.me/product-options/getting-started/manage-option-sets).

## 3. Select customers

Open **3. Select customers**, and under **Show option set to** choose who sees the option set:

* **All customers** (default)
* **Registered customers** - customers who are logged in to an account
* **Customers without accounts** - customers who are not logged in
* **Specific customers** - pick customers from your customer list
* **Specific customer tags** - customers who have one of the tags you enter, for example VIP, Wholesale or Member

Only **All customers** is available on every plan. The other choices need the **Platinum** plan.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FTRV3kHyTyXcuBLlMblOa%2FScreenshot%20(34).png?alt=media&amp;token=2d3e32df-4207-40fc-9eca-bbbfe6737aeb" alt=""><figcaption></figcaption></figure>

## Premium option set

A [Premium option set](https://docs.optis.me/product-options/getting-started/plans-and-features) can only be applied to **one product or one variant**. For it, the choices are limited to **Not assigned**, **Specific products** (one product) and **Specific variants** (one variant), and **Exclude products** is turned off.


# What to do if OPTIS Options aren’t showing on product pages?

If the option set is missing from your storefront, go through this checklist from top to bottom, most cases are fixed by the first couple of checks.

## 1. Check the app is active on your theme

Ensure the app is activated on your theme. Verify this in the theme editor and click **Save**.

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_95sjuc.png" alt=""><figcaption></figcaption></figure>

## 2. Check the option set is live and assigned

Confirm that your option set is **Live**, and assigned to your test product.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fyxt5YwEOLJy6YVinxQX9%2Ff.png?alt=media&amp;token=7bb10727-0df2-4ac0-992b-db49282b8979" alt=""><figcaption></figcaption></figure>

## 3. Check product assignment

* In [**2. Select products**](https://docs.optis.me/product-options/getting-started/assign-option-sets-to-products-and-customers#id-2.-select-products), make sure the product is included — not **Not assigned** or excluded.
* If several live option sets target the same product, only the one with the lowest [**Priority**](https://docs.optis.me/product-options/getting-started/assign-option-sets-to-products-and-customers#priority) number shows; check **Applied products** in **Option sets**.

## 4. Check customer targeting

In [**3. Select customers**](https://docs.optis.me/product-options/getting-started/assign-option-sets-to-products-and-customers#id-3.-select-customers), make sure your test customer matches — for example, **Registered customers** won't show to logged-out visitors.

## 5. Check visibility conditions

An option can stay hidden until another option is set. See [Visibility conditions](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

## 6. Check your plan

Some option types need a paid plan (e.g. **Date & time**, **Color picker**, **Email**, **Dropdown with thumbnail**). On the Free plan, try them on one product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).

## Other reasons options might not show

If the options still don’t appear, it might be due to:

* A conflict between the app and your theme.
* Multiple product options apps installed and enabled simultaneously.
* A conflict with another existing app in your store.

If you need further assistance with the above case, please contact us via live chat. Our support team is here to help!

## Other common questions

* **Options are not showing in the cart or at checkout** - this is usually caused by a theme and app incompatibility. Contact us via live chat and we will help.
* **The add-on price is not added to the product price** - install the code for [Show updated total price with add-ons](https://docs.optis.me/product-options/advanced-features/show-updated-total-price-with-add-ons) (**Advanced features > Show updated total price with add-ons**). You can also contact us to install it for free.
* **Clicking Add to cart goes to the cart page instead of the mini cart / cart drawer** - see [Work with your cart drawer / ajax cart](https://docs.optis.me/product-options/advanced-features/work-with-your-cart-drawer-ajax-cart).
* **I want to move the options on the product page** - see [Change option set position on product page](https://docs.optis.me/product-options/faq/change-option-set-position-on-product-page).


# OPTIS Storefront V2


# OPTIS Storefront V2 — Faster, Smarter, More Stable

Welcome to the next generation of OPTIS Product Options. Storefront V2 is a complete upgrade to how OPTIS loads and runs on your Shopify store.

## Why we're introducing Storefront V2

* We've rebuilt the storefront integration to improve performance and compatibility across modern Shopify themes.
* With V2, OPTIS becomes lighter, loads only when needed, and provides a stronger foundation for upcoming features.

## What's improved in Storefront V2?

### ⚡ Faster page load performance

Storefront V2 significantly improves how the app loads on your storefront.

Instead of injecting scripts across your entire store, OPTIS now loads only on pages where product options are actually needed.

**Benefits:**

* Faster storefront loading.
* Reduced unnecessary JavaScript.
* Better Lighthouse performance.
* Less impact on pages like Home, Collection, Blog, Cart, and other non-product pages.

### 🎯 Smarter script loading

V2 only initializes OPTIS when it's required.

**Benefits:**

* Product pages load product option logic only when customers visit them.
* Other pages remain lightweight and unaffected.
* Better overall browsing experience for customers.

### 🛡️ Better stability & theme compatibility

We've improved compatibility with a wider range of Shopify themes and storefront structures.

V2 is designed to:

* Work more reliably across different Online Store 2.0 themes.
* Reduce storefront conflicts with other apps.
* Improve behavior after Shopify theme updates.

### 🚀 Foundation for all future features

* Starting with Storefront V2, all new storefront features will be developed exclusively on V2. This allows us to ship improvements faster without maintaining two different storefront architectures.
* Future features will only be available on V2, including performance enhancements and upcoming storefront capabilities.

### 🔄 More reliable storefront updates

* Because V2 uses a new storefront architecture, updates can be released with fewer compatibility issues and a more consistent experience across stores.
* This also helps us resolve bugs faster and roll out improvements without affecting unrelated storefront pages.

## ⚠️ Important for stores with previous custom support

If you've previously contacted OPTIS Support for:

* theme customization,
* storefront code changes,
* custom integration,
* custom CSS or JavaScript,
* or any manual storefront fixes,

please contact our Support team before switching to Storefront V2.

We'll migrate those customizations to the new storefront architecture and verify everything is working correctly. This helps prevent custom storefront implementations from being lost or behaving differently after migration.

If you have any questions, please contact us via:

* Live Chat inside the OPTIS app.
* Email: **<support@optis.me>**

We're excited to help you move to a faster, more stable OPTIS storefront experience.


# How to upgrade to Storefront V2

Upgrade your store to OPTIS Storefront V2 from the app Dashboard, check your storefront afterwards, and switch back to Legacy storefront if you need to.

Not sure what Storefront V2 is? See [OPTIS Storefront V2 — Faster, Smarter, More Stable](https://docs.optis.me/product-options/optis-storefront-v2/optis-storefront-v2-faster-smarter-more-stable).

## Before you upgrade

If the OPTIS team ever added custom code to your storefront (custom styling, a custom position for the options, or a special integration), contact support before you upgrade. We will migrate that code to Storefront V2 for you, so nothing breaks on your product pages.

No custom code? You can upgrade right away.

## How to upgrade to Storefront V2

1. Open the OPTIS app and go to the **Dashboard**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FGqhoIODqxybEalfMMqNE%2Fimage.png?alt=media&amp;token=5d31813b-9545-49c4-9b7c-669d5342bb17" alt=""><figcaption></figcaption></figure>

2. On the **Storefront V2** box, click **Upgrade**.
3. In the **Upgrade to Storefront V2?** popup, tick **I understand I should review my storefront after upgrading.** The **Upgrade** button stays disabled until you tick this box.
4. Click **Upgrade**.
5. You will see the message **Upgraded to Storefront V2 successfully.** The Storefront V2 box now shows **Active**, and the Legacy storefront box shows **Inactive**.

Changed your mind in the popup? Click **Cancel** and nothing changes.

## After upgrading: check your storefront

Open a few product pages that use option sets and check them as a shopper would. If anything looks wrong, contact support or switch back to Legacy storefront.

* [ ] Options appear on the product page, in the right position
* [ ] Option styles (colors, fonts, swatches) look as before
* [ ] Conditional logic shows and hides the right options
* [ ] Add-on prices are added correctly to the product price
* [ ] Add to cart works, and the cart shows the chosen options and prices
* [ ] Checkout completes with the right total

## How to switch back to Legacy storefront

You can switch back anytime, but features that need Storefront V2 will stop working on your store. You can upgrade to Storefront V2 again later.

1. Go to the **Dashboard** and find the **Storefront version** card.
2. On the **Legacy storefront** box, click **Rollback**.
3. Tick **I understand that Storefront V2 features will stop working, and I'll review my storefront after switching.** The **Rollback** button stays disabled until you tick this box.
4. Click **Rollback**.
5. You will see the message **Switched back to Legacy storefront successfully.** Then check your product pages again with the checklist above.

Want those features back? Upgrade to Storefront V2 again from the same card.

## FAQ

**Do I have to upgrade?**\
No, Legacy storefront keeps working. But it only gets maintenance updates, and all new features ship on Storefront V2 only.

**Will my option sets change?**\
No. Upgrading changes how options load on the storefront, not your option set settings.

**Can I switch back?**\
Yes, anytime. See [How to switch back to Legacy storefront](#how-to-switch-back-to-legacy-storefront) above.

**Something looks wrong after upgrading. What should I do?**\
Contact OPTIS support via Live Chat inside the app or at **<support@optis.me>**, with the product page link. You can also switch back to Legacy storefront while we fix it.


# Text Input

Text input options let customers type information on the product page, such as a name, a message, a number, an email address or a phone number. In the option editor they are listed under **Text input**.

* [Text box](https://docs.optis.me/product-options/20-option-types/text-input/text-box) - a single-line field for short text, such as a name to engrave.
* [Text Area](https://docs.optis.me/product-options/20-option-types/text-input/text-area) - a multi-line field for longer messages or special instructions.
* [Number Field](https://docs.optis.me/product-options/20-option-types/text-input/number-field) - accepts numbers only, with optional minimum and maximum values.
* [Email Field](https://docs.optis.me/product-options/20-option-types/text-input/email-field) - checks that the customer enters a valid email address (Advanced plan and above).
* [Phone Field](https://docs.optis.me/product-options/20-option-types/text-input/phone-field) - a phone number with a country picker and optional format check (Advanced plan and above, Storefront V2 only).

All of them support **Required field**, **Placeholder text**, **Default value**, **Help text**, an optional **Price add-on** and [SKU](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works), and **Visibility** (conditional logic). See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).


# Text Area

A **Text area** is a multi-line box for longer text. Unlike a [Text box](https://docs.optis.me/product-options/20-option-types/text-input/text-box), customers can press **Enter** to start a new line or paragraph, and the box grows as they type.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FozkXgaKClYOLuLbMaSGk%2Fimage.png?alt=media&amp;token=84b2217f-77ef-47d9-b456-a34c9e2c81ca" alt=""><figcaption></figcaption></figure>

## When to use a Text area

* **Custom orders** - engraving text, name personalization, special requests.
* **Gift messages** - a note to include with the order, or delivery instructions.
* **Forms** - a short bio, cover letter, or a longer answer on an application.

## How to add a Text area option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Text area** under **Text input** 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%2Fcp5OkvlSvDBJN67rs8gg%2Fimage.png?alt=media&amp;token=80a40fae-2017-4beb-940e-c71008f386f0" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FUYdheN5YKE4V2FkKN6Ar%2Fimage.png?alt=media&amp;token=07338890-b90b-4b64-97d5-cdafc5de442e" alt=""><figcaption></figcaption></figure>

### Step 2: Name it

Enter the **Label on product** (e.g., "Note"). Use **Label on cart** if the cart and order should show a different name. Tick any options below based on your needs:

* **Required field** if customers must fill it in
* **Hide option label** to hide the label.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fewx7HeMdhUKwD3hGLPSl%2Fimage.png?alt=media&amp;token=6dcb9a36-2a08-4f15-bfaf-587f02bdafee" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Text area works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FIwbLUHlLzmk5uqvn5kjs%2Fimage.png?alt=media&amp;token=a9b5f75b-ac44-412d-8365-7b11fd77cb19" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FnsdFVZrfHiiIo1kvXxYR%2Fimage.png?alt=media&amp;token=cdda8bc1-a290-4f24-bebe-7ffab4d1dec8" alt=""><figcaption></figcaption></figure>

* **SKU** - a SKU for this field. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

### Default value and placeholder

* **Placeholder text** - a faded hint shown inside the field (e.g., "Type your message here"). It disappears once the customer starts typing. Available on every plan.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FGJ6QiiMObJHe7vVk4mAI%2Fimage.png?alt=media&amp;token=0117aa0b-facf-41c4-84ce-590c97b209b0" alt=""><figcaption></figcaption></figure>

How the placeholder looks on your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FpLidxiLtIvMONFGiPZ8R%2Fimage.png?alt=media&amp;token=378af729-5e52-4046-8a5d-09448c287b0f" alt=""><figcaption></figcaption></figure>

* **Default value** - text that is already filled in when the customer opens the product page. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FCECTDOawPxq0sC0C4LP6%2Fimage.png?alt=media&amp;token=f24b9780-7b12-4609-864a-942706bac90c" alt=""><figcaption></figcaption></figure>

Example: pre-fill the "Message" field with "Happy Birthday!" so it appears automatically when customers open the product page.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FwNPTLCYTg5UPkDw1JonV%2Fimage.png?alt=media&amp;token=30536909-160d-423c-b720-dc7ab49d7fa1" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to enter. Choose how it's shown: **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FuZoETiaRK2wqRlA2I367%2Fimage.png?alt=media&amp;token=5e6c5bf1-a9cd-4ef1-8835-e42b4ce3eb74" alt=""><figcaption></figcaption></figure>

Example of Help text shown as a Tooltip on the storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FZNuNZNWqN3XGOiVPf4pj%2Fimage.png?alt=media&amp;token=68bb3776-232a-46e2-a3e1-c7ae2ee6b1f5" alt=""><figcaption></figcaption></figure>

### Limit the number of characters

Set **Min character** and **Max character** to control how much customers can type. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F6WxIlHM6nf5qO97AtNwF%2Fimage.png?alt=media&amp;token=7f8932ef-3bf1-4ebb-919a-eb1a42625b41" alt=""><figcaption></figcaption></figure>

* **Min character** - if the customer's text is shorter than this, OPTIS shows a message under the field, e.g. **Min character: 5**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F1iiAqHZBtAIoMFnzythe%2Fimage.png?alt=media&amp;token=5d848198-b2fe-4311-9a86-ee1a68b485e8" alt=""><figcaption></figcaption></figure>

* **Max character** - once the customer reaches this limit, OPTIS stops accepting more input and shows a message under the field, e.g. **Max character: 50**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F5ooq1g12bGfAUlwGj3WA%2Fimage.png?alt=media&amp;token=fd51452e-6960-4821-9396-b05a908788a9" alt=""><figcaption></figcaption></figure>

* **Character counter (optional)** - turn on **Character count for text box** in **Settings > General Settings > Option type setting > Text input** to also show a running count (e.g. **12/50 characters**) under the field. See [Limit Characters for Text Input](https://docs.optis.me/product-options/faq/limit-characters-for-text-input).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FEYXPjoDQOAJSxeqOLYh7%2Fimage.png?alt=media&amp;token=53f083de-b2ea-401d-aa98-427e5e6f1a9f" alt=""><figcaption></figcaption></figure>

### Charge an extra fee (price add-on)

Charge more when a customer fills in this field. Available on the **Advanced** plan and above; **Upsell product** needs **Platinum**.

* **Extra fee** - adds a fixed amount to the price. See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F2U5NCDXlGArLtlA8vZAb%2Fimage.png?alt=media&amp;token=922c51b2-1e84-4996-b8f4-1c70cd9e4487" alt=""><figcaption></figcaption></figure>

How the price add-on looks on the storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FUTZUo09JvpwDDk54eQmv%2Fimage.png?alt=media&amp;token=83d93037-719e-410f-b476-af571d771956" alt=""><figcaption></figcaption></figure>

* **Upsell product** - links the fee to a Shopify variant's price and stock. See [How to Use "Upsell product"?](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FtFo6BcUjQoo15TXhNl3I%2FScreenshot%20-%202026-01-12T135810.931.png?alt=media&amp;token=6759fec8-33d8-4bbe-bfe8-3477da229a96" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

* Show or hide the Text area based on another option - for example, only show a "Message" field when the customer answers "Yes" to "Would you like to leave a message?".
* Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FKRCOu5WWJxlbvwBqLM1o%2Fimage.png?alt=media&amp;token=d61af973-990b-45dc-b17e-f2b3078626db" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Text area takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FHtNQX1F4OiBaMZYF4JJ4%2Fimage.png?alt=media&amp;token=47d2c9c9-9649-4ce0-b274-4c1dbee9279a" alt=""><figcaption></figcaption></figure>

## Related guides

* [Text box](https://docs.optis.me/product-options/20-option-types/text-input/text-box)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use "Upsell product"?](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Text box

A **Text box** is a single-line field for short text - unlike a [Text area](https://docs.optis.me/product-options/20-option-types/text-input/text-area), it holds one line only, so it's best for short answers.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FscY89BPAGBuuyagJ4E6v%2Fimage.png?alt=media&amp;token=10e0987e-afa0-4d21-b62f-44ba8b7abe56" alt=""><figcaption></figcaption></figure>

## When to use a Text box

* **Personalization** - a name or short message to engrave or print.
* **Forms** - a shipping address, a note, or another short detail.
* **Order notes** - a comment or special request for the order.

## How to add a Text box option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Text box** under **Text input** 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%2FnGaqznnR0Koevt5envVQ%2Fimage.png?alt=media&amp;token=9e4c27b9-7b1c-4103-bfb6-07eb4181ac6f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FIMGJIVd8CeBNp519dXGX%2Fimage.png?alt=media&amp;token=2485a906-fba2-4ed4-898a-697051f3621b" alt=""><figcaption></figcaption></figure>

### Step 2: Name it

Enter the **Label on product** (e.g., "Input your name", "Note"). Use **Label on cart** if the cart and order should show a different name. Tick any options below based on your needs:

* **Required field** if customers must fill it in
* **Hide option label** to hide the label

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FCDKTzXfZiiWSGuiFgSTg%2Fimage.png?alt=media&amp;token=d24efc17-c4ae-42c3-9102-45aec276f32e" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Text box works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FAgzgh5gbp5511rgPSnSQ%2Fimage.png?alt=media&amp;token=0edecc1e-1563-4204-a23f-cabd8738f576" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FnsdFVZrfHiiIo1kvXxYR%2Fimage.png?alt=media&amp;token=cdda8bc1-a290-4f24-bebe-7ffab4d1dec8" alt=""><figcaption></figcaption></figure>

* **SKU** - a SKU for this field. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

### Default value and placeholder

* **Placeholder text** - a faded hint shown inside the field (e.g., "Type your message here"). It disappears once the customer starts typing. Available on every plan.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FGJ6QiiMObJHe7vVk4mAI%2Fimage.png?alt=media&amp;token=0117aa0b-facf-41c4-84ce-590c97b209b0" alt=""><figcaption></figcaption></figure>

How the placeholder looks on your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F7junpvfI8eabjUFvSkkC%2FScreenshot%20-%202026-01-12T143933.865.png?alt=media&amp;token=68782870-2072-4ea0-9be9-21dc4ccae2ff" alt=""><figcaption></figcaption></figure>

* **Default value** - text that is already filled in when the customer opens the product page. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FCECTDOawPxq0sC0C4LP6%2Fimage.png?alt=media&amp;token=f24b9780-7b12-4609-864a-942706bac90c" alt=""><figcaption></figcaption></figure>

Example: pre-fill the "Message" field with "Happy Birthday!" so it appears automatically when customers open the product page.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F92WrhS87ArNcJNcG07iq%2FScreenshot%20-%202026-01-12T142138.473.png?alt=media&amp;token=b04ca98f-3d6e-4216-89c1-9179c58dc242" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to enter. Choose how it's shown: **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FuZoETiaRK2wqRlA2I367%2Fimage.png?alt=media&amp;token=5e6c5bf1-a9cd-4ef1-8835-e42b4ce3eb74" alt=""><figcaption></figcaption></figure>

### Limit the number of characters

Set **Min character** and **Max character** to control how much customers can type. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQasiki9gWmsLt4E9AY1f%2FScreenshot%20-%202026-01-12T144027.912.png?alt=media&amp;token=b095b54f-2b70-4e91-84e9-650d4fcf07c6" alt=""><figcaption></figcaption></figure>

* **Min character** - if the customer's text is shorter than this, OPTIS shows a message under the field, e.g. **Min character: 10**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fv26xkV4yR45PP29gh05C%2FScreenshot%20-%202026-01-12T144123.577.png?alt=media&amp;token=df8ae210-6121-4e1f-a8a5-2de76cd62cc1" alt=""><figcaption></figcaption></figure>

* **Max character** - once the customer reaches this limit, OPTIS stops accepting more input and shows a message under the field, e.g. **Max character: 50**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fri4uXj9FK1ICwvviXlOX%2Fimage.png?alt=media&amp;token=3b26b870-c84b-4799-a4ae-004a4900bfbb" alt=""><figcaption></figcaption></figure>

* **Character counter (optional)** - turn on **Character count for text box** in **Settings > General Settings > Option type setting > Text input** to also show a running count (e.g. **12/50 characters**) under the field. See [Limit Characters for Text Input](https://docs.optis.me/product-options/faq/limit-characters-for-text-input).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F5D2U7lLWE40J4D5uqPSa%2Fimage.png?alt=media&amp;token=01937bda-7391-4583-a032-49e902e5b02d" alt=""><figcaption></figcaption></figure>

### Charge an extra fee (price add-on)

Charge more when a customer fills in this field. Available on the **Advanced** plan and above; **Upsell product** needs **Platinum**.

* **Extra fee** - adds a fixed amount to the price. See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FdD3AXyj1RXRbLRfA2rHv%2Fimage.png?alt=media&amp;token=b4d523fb-5558-49be-8aac-eb57d4fd2721" alt=""><figcaption></figcaption></figure>

How the price add-on looks on the storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLaCXYprKy0prT4HINspP%2Fimage.png?alt=media&amp;token=ede154b1-a92b-4faf-80e4-10adea6e2fc7" alt=""><figcaption></figcaption></figure>

* **Upsell product** - links the fee to a Shopify variant's price and stock. See [How to Use "Upsell product"?](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FNQEnillZKrOA5zEnGWuy%2FScreenshot%20(2).png?alt=media&amp;token=a5eda0b1-43d4-406d-b23e-a9a574b7c147" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Text box based on another option - for example, only show it when the customer answers "Yes" to "Would you like to personalize this item?". Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FoMJ1lw7yoh25TvvlQpRn%2Fimage.png?alt=media&amp;token=09e2d10d-ff45-4a8e-8466-d6dde5b6ed23" alt=""><figcaption></figcaption></figure>

### Preview the text on the product (live mockup)

Show the text customers type directly on the product image, updated in real time. Available on the **Platinum** plan and above. See [Product Personalizer - Live Mockup Settings](https://docs.optis.me/product-options/advanced-setup/product-personalizer-live-mockup-settings).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FwAH65NnA2nmEDzlvlEpd%2Fimage.png?alt=media&amp;token=0418eb60-4546-4fb1-9e9d-0466f0bd293b" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Text box takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F807HMv7Ip9q8gxznlXtX%2Fimage.png?alt=media&amp;token=99b9da3f-05d9-4cd3-8d30-82c9218dc599" alt=""><figcaption></figcaption></figure>

## Related guides

* [Text area](https://docs.optis.me/product-options/20-option-types/text-input/text-area)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use "Upsell product"?](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)
* [Product Personalizer - Live Mockup Settings](https://docs.optis.me/product-options/advanced-setup/product-personalizer-live-mockup-settings)


# Number Field

A **Number Field** only accepts numbers - letters and symbols aren't allowed - so it's ideal for quantities, dimensions or counts.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fr4gv5TrUposkU0KZftym%2Fimage.png?alt=media&amp;token=9d881b7b-67d2-4650-97f4-60e703612220" alt=""><figcaption></figcaption></figure>

## When to use a Number Field

* **Personalization** - a quantity of engraved characters, a jersey number, or a custom size.
* **Catering and events** - number of guests, servings, or portions.
* **Specifications** - battery life, storage size, weight, or dimensions.

## How to add a Number Field option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Number field** under **Text input** 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%2FnGaqznnR0Koevt5envVQ%2Fimage.png?alt=media&amp;token=9e4c27b9-7b1c-4103-bfb6-07eb4181ac6f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FsSg66SpZQAm2HSOZ7hsE%2Fimage.png?alt=media&amp;token=5a29a778-e5b7-4bd3-afb1-2862e152b8b3" alt=""><figcaption></figcaption></figure>

### Step 2: Name it

Enter the **Label on product** (e.g., "Number of additional gift boxes", "Grade"). Use **Label on cart** if the cart and order should show a different name. Tick any options below based on your needs:

* **Required field** if customers must fill it in
* **Hide option label** to hide the label

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F4tQD4BSY83XvKVY5DmSw%2Fimage.png?alt=media&amp;token=8b846f52-23a1-4ab4-807d-f7c9dc39fa42" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Number Field works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FgluvdwLehsm3USCf2wwQ%2Fimage.png?alt=media&amp;token=a67b3e58-4a9a-414e-99c2-e2b252b56cea" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FnsdFVZrfHiiIo1kvXxYR%2Fimage.png?alt=media&amp;token=cdda8bc1-a290-4f24-bebe-7ffab4d1dec8" alt=""><figcaption></figcaption></figure>

* **SKU** - a SKU for this field. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

### Default value and placeholder

* **Placeholder text** - a faded hint shown inside the field. It disappears once the customer starts typing. Available on every plan.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FGJ6QiiMObJHe7vVk4mAI%2Fimage.png?alt=media&amp;token=0117aa0b-facf-41c4-84ce-590c97b209b0" alt=""><figcaption></figcaption></figure>

How the placeholder looks on your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FcchfYQXcezu8nUWLlcrv%2Fimage.png?alt=media&amp;token=c4fad7b3-1f17-4930-a0f0-a2b257fae171" alt=""><figcaption></figcaption></figure>

* **Default value** - a number that is already filled in when the customer opens the product page. Available on the **Advanced** plan and above.

Example: pre-fill "Number of additional gift boxes" with "2" so it appears automatically when customers open the product page.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FP4oD0taEIg2BiU1mm1U5%2Fimage.png?alt=media&amp;token=7f8bae05-5174-4020-8def-bb7636ef3485" alt=""><figcaption></figcaption></figure>

How it looks on your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FCrlLTq4qPRz8M8QinZQM%2Fimage.png?alt=media&amp;token=236c5f28-c3d9-446f-bf0a-c9d26906f11d" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to enter. Choose how it's shown: **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FBLpbgq7IzlkqYz4oKD0n%2Fimage.png?alt=media&amp;token=7a69e316-a7e8-439b-b0af-f65d16c8e262" alt=""><figcaption></figcaption></figure>

### Limit the value

Set **Min value** and **Max value** to control the numbers customers can enter. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FkVCXlIHQiUHVgKJFLeBb%2Fimage.png?alt=media&amp;token=2fcc6576-814c-4d93-909b-59ef26253cfa" alt=""><figcaption></figcaption></figure>

* If a customer enters a number below the minimum or above the maximum, OPTIS shows a message below the field (e.g., **Min value: 10**).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FUMQCiQo98VeJ65UeBGqv%2Fimage.png?alt=media&amp;token=940e88d3-0828-412c-bbee-aaa365087c59" alt=""><figcaption></figcaption></figure>

* You can change the wording in **Settings > Translation Texts > Default text customization > Product page**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FR1PiPIpbIxPZLxv3J8LI%2Fimage.png?alt=media&amp;token=f72b170b-688e-4c94-b72c-4464c923c931" alt=""><figcaption></figcaption></figure>

### Charge an extra fee (price add-on)

Charge more when a customer fills in this field. Available on the **Advanced** plan and above; **Upsell product** needs **Platinum**.

* **Extra fee** - adds a fixed amount to the price. See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FXRE9uRyYrXWGBuB4W3Uw%2Fimage.png?alt=media&amp;token=28e8cc97-c1c8-4ec9-9dfd-572da01b0df3" alt=""><figcaption></figcaption></figure>

How the price add-on looks on the storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FjqEXidjDsjurIzzYLq7h%2Fimage.png?alt=media&amp;token=ca3f9f38-1515-490f-a283-5928ca592275" alt=""><figcaption></figcaption></figure>

* **Upsell product** - links the fee to a Shopify variant's price and stock. See [How to Use "Upsell product"?](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fwm8ZKerppVW4MvfD2Fe6%2Fimage.png?alt=media&amp;token=bb87a5aa-1d1e-42a7-8fcd-fcfb9dcd9eed" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Number Field based on another option - for example, only show a "Year" field when the customer answers "Yes" to "Are you a student?". Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FYMiROVmKKnk5FESaQC94%2Fimage.png?alt=media&amp;token=b7a9f6c1-e3b5-4a92-9d57-58db3aff5256" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Number Field takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F807HMv7Ip9q8gxznlXtX%2Fimage.png?alt=media&amp;token=99b9da3f-05d9-4cd3-8d30-82c9218dc599" alt=""><figcaption></figcaption></figure>

## Related guides

* [Text box](https://docs.optis.me/product-options/20-option-types/text-input/text-box)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use "Upsell product"?](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Email Field

An **Email Field** is a single-line field that only accepts a valid email address (it checks for an "@" and a domain).

{% hint style="info" %}
**Plan:** **Email** is available on the **Advanced** plan and above. On the Free plan you can still try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FkEfsD7En80auRektkXjv%2Fimage.png?alt=media&amp;token=994323d3-5852-4394-933b-a80a8ecfa0b3" alt=""><figcaption></figcaption></figure>

If a customer types something that isn't a valid email, OPTIS shows a message under the field:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FBclnZxk1oTMQgKsmxQzJ%2Fimage.png?alt=media&amp;token=fae483e8-5764-4a98-9200-9ff50f951964" alt=""><figcaption></figcaption></figure>

## When to use an Email Field

* **Account or newsletter signup** - collect an email to send updates or promotions.
* **Event registration** - send tickets, reminders, or access links.
* **Contact for a custom order** - so you can follow up about a personalized item.

## How to add an Email Field option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Email** under **Text input** 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%2FnGaqznnR0Koevt5envVQ%2Fimage.png?alt=media&amp;token=9e4c27b9-7b1c-4103-bfb6-07eb4181ac6f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FzdBigZIAx96ctTuCcFZU%2Fimage.png?alt=media&amp;token=2d90508a-b5de-45ef-94fa-d720ee5a2d37" alt=""><figcaption></figcaption></figure>

### Step 2: Name it

Enter the **Label on product** (e.g., "Enter your email address:"). Use **Label on cart** if the cart and order should show a different name. Tick any options below based on your needs:

* **Required field** if customers must fill it in
* **Hide option label** to hide the label

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fmrn6m7bAD1e3pa6L3uwg%2Fimage.png?alt=media&amp;token=e2a29fc4-0ed1-4976-a9c5-64a8fa54dd0a" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Email Field works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FPtcoPVjZGrKLSGrGZkeH%2Fimage.png?alt=media&amp;token=b3fbe35f-77d8-4ebd-94ec-6284b78e4bb5" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FMPi1HmnV2J8mxVkb3lGR%2Fimage.png?alt=media&amp;token=1eddf53b-7e09-4057-8976-021328ad8b98" alt=""><figcaption></figcaption></figure>

* **SKU** - a SKU for this field. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

### Default value and placeholder

* **Placeholder text** - a faded hint shown inside the field. It disappears once the customer starts typing. Available on every plan.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FGJ6QiiMObJHe7vVk4mAI%2Fimage.png?alt=media&amp;token=0117aa0b-facf-41c4-84ce-590c97b209b0" alt=""><figcaption></figcaption></figure>

How the placeholder looks on your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FgHWhriSA9aw4KbAjjO47%2FScreenshot%20-%202026-01-12T151444.081.png?alt=media&amp;token=19a2eae2-8e18-4f32-8d12-2530f87a6fbf" alt=""><figcaption></figcaption></figure>

* **Default value** - an email that is already filled in when the customer opens the product page. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FCECTDOawPxq0sC0C4LP6%2Fimage.png?alt=media&amp;token=f24b9780-7b12-4609-864a-942706bac90c" alt=""><figcaption></figcaption></figure>

How it looks on your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQ659RDljtkry1NAW95OJ%2FScreenshot%20-%202026-01-12T151302.465.png?alt=media&amp;token=2b71276d-48bd-4dfc-a1d9-a2e941a8fd5f" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to enter. Choose how it's shown: **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FuZoETiaRK2wqRlA2I367%2Fimage.png?alt=media&amp;token=5e6c5bf1-a9cd-4ef1-8835-e42b4ce3eb74" alt=""><figcaption></figcaption></figure>

### Limit the number of characters

Set **Min character** and **Max character** to control how much customers can type. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FkVCXlIHQiUHVgKJFLeBb%2Fimage.png?alt=media&amp;token=2fcc6576-814c-4d93-909b-59ef26253cfa" alt=""><figcaption></figcaption></figure>

* **Min character** - if the customer's email is shorter than this, OPTIS shows a message under the field, e.g. **Min character: 5**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F0G3mhoanrVDJxjuEaEek%2Fimage.png?alt=media&amp;token=0e725ba7-02b9-42c3-99b3-f1240f1a2f90" alt=""><figcaption></figcaption></figure>

* **Max character** - once the customer reaches this limit, OPTIS stops accepting more input and shows a message under the field, e.g. **Max character: 20**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FP2DM4APUtpBtBObnEPLt%2Fimage.png?alt=media&amp;token=bbe4c683-0272-4d03-953b-b3a1fdfa17a2" alt=""><figcaption></figcaption></figure>

* **Character counter (optional)** - turn on **Character count for text box** in **Settings > General Settings > Option type setting > Text input** to also show a running count (e.g. **12/50 characters**) under the field. See [Limit Characters for Text Input](https://docs.optis.me/product-options/faq/limit-characters-for-text-input).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FYzrPF2Mwb8N3G4II7jMw%2Fimage.png?alt=media&amp;token=4a92407c-3d40-47b2-b804-fdf4923c4bac" alt=""><figcaption></figcaption></figure>

* **Not a valid email?** Regardless of length, OPTIS shows **Email format is invalid.** You can change this text in **Settings > Translation Texts > Default text customization > Product page**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FVL53oh9ccKIV970hyXRL%2Fimage.png?alt=media&amp;token=88ff808b-c39b-41e9-a492-55e1b54f67aa" alt=""><figcaption></figcaption></figure>

### Charge an extra fee (price add-on)

Charge more when a customer fills in this field. Available on the **Advanced** plan and above; **Upsell product** needs **Platinum**.

* **Extra fee** - adds a fixed amount to the price. See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FBsdyjPgNba7b53JAzSMp%2Fimage.png?alt=media&amp;token=af84983e-d193-4d2a-90ca-d8d093b7eadd" alt=""><figcaption></figcaption></figure>

How the price add-on looks on the storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FBT2OKs83cbmj5DJXLUGt%2Fimage.png?alt=media&amp;token=6e26479c-86e4-45c5-b8eb-c8ad816f360c" alt=""><figcaption></figcaption></figure>

* **Upsell product** - links the fee to a Shopify variant's price and stock. See [How to Use "Upsell product"?](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fwm8ZKerppVW4MvfD2Fe6%2Fimage.png?alt=media&amp;token=bb87a5aa-1d1e-42a7-8fcd-fcfb9dcd9eed" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Email Field based on another option - for example, only show it when the customer answers "Yes" to "Would you like to receive exclusive emails with discounts and product updates?". Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FKnLv1gyCueUnT7Hx43bc%2Fimage.png?alt=media&amp;token=2c21538e-58f2-4142-a833-0227d304e93c" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Email field takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FWug2fevocSR8UeI5dp2u%2Fimage.png?alt=media&amp;token=a01bb229-a165-4b62-98e3-12ae18dca62c" alt=""><figcaption></figcaption></figure>

## Related guides

* [Text box](https://docs.optis.me/product-options/20-option-types/text-input/text-box)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use "Upsell product"?](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Phone Field

A **Phone Field** lets customers pick their country from a flag list and type a phone number. Only digits are accepted, and the number is saved with its country code (e.g. **+84 371 234 567**).

✨ [Demo product](https://optis-product-options-variant.myshopify.com/products/phone)

{% hint style="info" %}
**Plan:** **Phone** is available on the **Advanced** plan and above. On the Free plan you can still try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).

**Storefront:** **Phone** works on [OPTIS Storefront V2](https://docs.optis.me/product-options/optis-storefront-v2) only. On the legacy storefront it shows a **Storefront V2** badge in the editor and is not displayed on the product page.
{% endhint %}

## When to use a Phone Field

* **Delivery or installation contact** - a number the courier or installer can call.
* **Gift recipient** - the recipient's number for flowers, cakes or surprise deliveries.
* **Booking confirmation** - confirm a reservation or appointment by call or SMS.

## How to add a Phone Field option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Phone** under **Text input** 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%2FqXBK2iL8v8yjgziIy1nj%2Fimage.png?alt=media&amp;token=294fbf84-bd9a-4b80-ac19-8ad926b28d71" alt=""><figcaption></figcaption></figure>

### Step 2: Name it

Enter the **Label on product** (e.g., "Phone number"). Use **Label on cart** if the cart and order should show a different name. Tick any options below based on your needs:

* **Required field** if customers must fill it in
* **Hide option label** to hide the label

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F1NUZDmmQY356RPNWMNzr%2Fimage.png?alt=media&amp;token=46fe59c3-f486-45fd-9ec5-687580694238" alt=""><figcaption></figcaption></figure>

### Step 3: Choose the countries

* **Country selection** - **All countries** (default), or **Selected countries only** to limit the list, e.g. to the countries you ship to.
* **Country values** - shown with **Selected countries only**. Search and tick the countries to allow.
* **Default country** - the country pre-selected on the product page. It starts as your store's country.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FWsBgEWAMV4hBnRvFAX1P%2Fimage.png?alt=media&amp;token=0b016622-1c6a-4f26-8997-e8176daf00a8" alt=""><figcaption></figcaption></figure>

### Step 4: Save and test

Click **Save**, then open the product page on your store. Try switching the country, typing a number and adding the product to cart.

## Option settings

Set only what you need - all of the settings below are optional.

* **Addon**: Charge more when a customer fills in this field. Available on the **Advanced** plan and above; **Upsell product** needs **Platinum**.
  * **Extra fee** - adds a fixed amount to the price. See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
  * **Upsell product** - links the fee to a Shopify variant's price and stock. See [How to Use "Upsell product"?](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value).
* **SKU** - a SKU for this field. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FpHeTFpqANunKnmanvNYJ%2Fimage.png?alt=media&amp;token=a6880bdc-e93d-49a6-8645-46a68cfcdb8f" alt=""><figcaption></figcaption></figure>

### Validate phone number

Tick **Validate phone number** to block **Add to cart** when the number does not match the phone format of the selected country. The number is also formatted as the customer types (e.g. **(201) 555-0123** for the United States), and OPTIS removes a leading 0 or a repeated country code before saving.

* If the number is not valid, OPTIS shows **Phone number is invalid.** under the field. You can change this text in **Settings > Translation Texts > Default text customization > Product page**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FSPGPbPjPOYj94EN6CCP2%2Fimage.png?alt=media&amp;token=66d04f8e-d396-41a3-ad36-5358e3cada1d" alt=""><figcaption></figcaption></figure>

* When the box is not ticked, any digits are accepted and saved as typed, with the country code in front (e.g. **+84 0371234567**).

### Option text

* **Placeholder text** - a faded hint shown inside the field. Leave it empty to show an example number for the selected country instead. Available on every plan.
* **Default value** - a number (digits only) that is already filled in when the customer opens the product page. If **Validate phone number** is on, it must be a valid number for the default country. Available on the **Advanced** plan and above.
* **Help text -** Add a short note explaining what to enter. Choose how it's shown: **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FJpLsVc8hgSTHDJa99hQw%2Fimage.png?alt=media&amp;token=fa87e058-be68-4997-a641-c952c6484593" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Phone Field based on another option - for example, only show it when the customer answers "Yes" to "Would you like a call before delivery?". Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FkMo3UqZyphaWIFV4OS6U%2Fimage.png?alt=media&amp;token=f2fe308f-9903-4b81-94c7-be1a7d007436" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Phone Field takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FTzm0SEphhTO1LDdPQjtK%2Fimage.png?alt=media&amp;token=60dbd476-5a0e-4b3d-840a-a99b992a75eb" alt=""><figcaption></figcaption></figure>

## Related guides

* [Email Field](https://docs.optis.me/product-options/20-option-types/text-input/email-field)
* [Text box](https://docs.optis.me/product-options/20-option-types/text-input/text-box)
* [Export and Import Option Sets](https://docs.optis.me/product-options/advanced-setup/export-and-import-option-sets) - Phone settings are exported in the **Phone\_settings** column.
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Choice list

Choice list options let customers pick from a list of values you define. In the option editor they are listed under **Choice list**.

* [Switch](https://docs.optis.me/product-options/20-option-types/choice-list/switch) - an on/off toggle for each value (Platinum plan and above).
* [Checkbox](https://docs.optis.me/product-options/20-option-types/choice-list/checkbox) - customers can select one or several values.
* [Dropdown menu](https://docs.optis.me/product-options/20-option-types/choice-list/dropdown-menu) - a compact list, with an optional search bar.
* [Dropdown Menu with Thumbnails](https://docs.optis.me/product-options/20-option-types/choice-list/dropdown-menu-with-thumbnails) - a dropdown with a color or image next to each value (Platinum plan and above).
* [Radio Button](https://docs.optis.me/product-options/20-option-types/choice-list/radio-button) - customers choose exactly one value.
* [Font Picker](https://docs.optis.me/product-options/20-option-types/choice-list/font-picker) - lets customers choose a font, and can preview it in a text field (Advanced plan and above).

Each value can have its own **Add-on** price, [SKU](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works), **Help text** and **Quantity**. Use the **Columns** button of the **Option values** table to show or hide these columns, and the **Default** column to pre-select a value.


# Switch

A **Switch** is an on/off toggle for a value - customers turn it on with a single click. Use several switches together when more than one choice is allowed.

{% hint style="info" %}
**Plan:** **Switch** is available on the **Platinum** plan and above. On the Free plan you can still try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FEimKbGLypc4KUjjIibYn%2Fimage.png?alt=media&amp;token=feffb83d-e6fa-45cf-81cb-456df00471c0" alt=""><figcaption></figcaption></figure>

## When to use a Switch

* **Product features** - turn on gift wrapping or another add-on service.
* **Yes/No questions** - a single clear choice, such as opting in to updates.

## How to add a Switch option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Switch** under **Choice list** 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%2FnGaqznnR0Koevt5envVQ%2Fimage.png?alt=media&amp;token=9e4c27b9-7b1c-4103-bfb6-07eb4181ac6f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F7SNSXVUviYMlPoJxpwmf%2Fimage.png?alt=media&amp;token=a273c879-2853-440f-a058-a5cfafaabcb3" alt=""><figcaption></figcaption></figure>

### Step 2: Name it and add values

Enter the **Label on product** (e.g., "Add Gift Box and Greeting Card") and add the **Option values** (e.g., Yes/No). Tick **Required field** if customers must choose before checking out, or **Hide option label** to hide the label.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FDkR9FpAnbpfB1rO22vyh%2Fimage.png?alt=media&amp;token=7061e92c-00bf-4ee2-af92-fd1713f36177" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Switch works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FK4kPwg2t7yVb7pdfVpvw%2Fimage.png?alt=media&amp;token=5ff7c86e-73c3-4484-8b11-42d4e976d208" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional. In the **Option values** table, click **Columns** to show **Add-on**, **Help text**, **SKU** or **Quantity** for each value:

* **Add-on** - charge extra for a value (**Extra fee**, Advanced plan and above) or link it to a Shopify variant (**Upsell product**, Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - a SKU for that value. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).
* **Quantity** - let customers choose how many of that value they want. Platinum plan and above. See [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FHIYGy9d00dUl7gzjRMgI%2Fimage.png?alt=media&amp;token=9e4036c3-8c1f-425c-9c22-50eea12372e5" alt=""><figcaption></figcaption></figure>

### Default value

Toggle **Default** for the value that should be pre-selected when the customer opens the product page. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F6ivXRpEBLeNAdLBeTloD%2Fimage.png?alt=media&amp;token=3c9fbec4-bb8b-4e9e-8a86-bbce3e00861e" alt=""><figcaption></figcaption></figure>

How it looks on your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FuVhDfUL8mWDBuJLDaBbF%2Fimage.png?alt=media&amp;token=f79b99dd-0ce7-41c1-9aa9-9204b4a9e167" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to choose, shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**. Available on the **Platinum** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FuZoETiaRK2wqRlA2I367%2Fimage.png?alt=media&amp;token=5e6c5bf1-a9cd-4ef1-8835-e42b4ce3eb74" alt=""><figcaption></figcaption></figure>

Example of Help text shown as a Tooltip on the storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F1neSoZCiwSc1WafqTTsh%2Fimage.png?alt=media&amp;token=79008b1b-1ceb-430c-95bd-e4a0b777ea58" alt=""><figcaption></figcaption></figure>

### Limit how many values can be selected

Set **Min** and **Max** to control how many values a customer can turn on. If they turn on fewer or more than allowed, OPTIS shows a message below the field, e.g. **Min selector: 2** or **Max selector: 5**. Available on the **Advanced** plan and above. See [Limit Min/Max Selectors](https://docs.optis.me/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FElWJqztv15QsmpCF9GS5%2Fimage.png?alt=media&amp;token=f4bacab4-1c3f-44e3-9427-4198a2418b7c" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Switch based on another option. Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FcQwQPjRflLW60VUOQBqn%2Fimage.png?alt=media&amp;token=34ba7a93-91b6-41e4-8805-07fc329cd007" alt=""><figcaption></figcaption></figure>

### Layout

In the **Display** tab: set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the option takes, and **Option value orientation** (**Horizontal** or **Vertical**) to lay the values out in a row or stack them.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FMIi06ybckZsi39l38i4O%2Fimage.png?alt=media&amp;token=80d1c422-40ce-4612-88d4-55a0337a65d2" alt=""><figcaption></figcaption></figure>

## Related guides

* [Checkbox](https://docs.optis.me/product-options/20-option-types/choice-list/checkbox)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options)
* [Limit Min/Max Selectors](https://docs.optis.me/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Checkbox

A **Checkbox** is a small square that customers click to select or deselect a value. Customers can pick one, several, or none - it shows a checkmark when selected.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FaLmLr1GZA2Orpe1wvjmj%2Fimage_kd0nv5.png?alt=media&amp;token=860dbcec-fe90-47b3-854b-08e046545bac" alt=""><figcaption></figcaption></figure>

## When to use a Checkbox

* **Product customization** - add-ons like gift wrapping, extra toppings, or scent/flavor options.
* **Compliance and agreements** - confirm age eligibility, agree to terms, or accept a return policy.

## How to add a Checkbox option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Checkbox** under **Choice list** 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%2FnGaqznnR0Koevt5envVQ%2Fimage.png?alt=media&amp;token=9e4c27b9-7b1c-4103-bfb6-07eb4181ac6f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F4v5wzcQZ2guGpRuDrUsa%2Fimage.png?alt=media&amp;token=acd0ae47-6469-4711-95b0-2c0a75f20869" alt=""><figcaption></figcaption></figure>

### Step 2: Name it and add values

Enter the **Label on product** (e.g., "Choose Scent") and add the **Option values** (e.g., Lavender, Vanilla, Eucalyptus). Tick any options below based on your needs:

* **Required field** if customers must choose before checking out
* **Hide option label** to hide the label above the values

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FdfotyvV9RVHpmt5gUvWN%2Fimage.png?alt=media&amp;token=4b2532b4-c96c-4fbf-8a9d-c4a581197dcd" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Checkbox works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FEpO37FW9ZJTET3K2nIjW%2Fimage.png?alt=media&amp;token=9838a90d-1772-4e93-bee6-04f6204c3d9e" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional. In the **Option values** table, click **Columns** to show **Add-on**, **Help text**, **SKU** or **Quantity** for each value:

* **Add-on** - charge extra for a value (**Extra fee**, Advanced plan and above) or link it to a Shopify variant (**Upsell product**, Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - a SKU for that value. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).
* **Quantity** - let customers choose how many of that value they want. Platinum plan and above. See [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FWg1tSemeX6zm9eTdZyNj%2Fimage.png?alt=media&amp;token=f4e152d9-92ab-41b4-b701-fc77dae57657" alt=""><figcaption></figcaption></figure>

### Default value

Toggle **Default** for the value that should be pre-selected when the customer opens the product page. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F4omk4rIMKpWhqshNBpJC%2Fimage.png?alt=media&amp;token=afc2ea88-0960-4542-9a5e-388ed54df223" alt=""><figcaption></figcaption></figure>

How it looks on your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FYju2DZ3jbtntUMHZoZXQ%2Fimage.png?alt=media&amp;token=0fb160a8-b58c-4748-81b2-581b8bb637ec" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to choose, shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**. Available on the **Platinum** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FuZoETiaRK2wqRlA2I367%2Fimage.png?alt=media&amp;token=5e6c5bf1-a9cd-4ef1-8835-e42b4ce3eb74" alt=""><figcaption></figcaption></figure>

Example of Help text shown as a Tooltip on the storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FFvoFdKT3uLNLujaqQgXn%2Fimage.png?alt=media&amp;token=e298569d-ecf0-4fa7-9846-5ca796636c19" alt=""><figcaption></figcaption></figure>

### Limit how many values can be selected

Set **Min** and **Max** to control how many values a customer can pick. Available on the **Advanced** plan and above. See [Limit Min/Max Selectors](https://docs.optis.me/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FNNyG1E9Qv7KZbzrGnn9N%2Fimage.png?alt=media&amp;token=0a732c1e-ed77-4a4d-aedb-534b23c11f83" alt=""><figcaption></figcaption></figure>

If a customer picks fewer or more values than allowed, OPTIS shows a message below the field.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FeYNe2jR3SZGTCM6TR1MJ%2Fimage.png?alt=media&amp;token=f9e774ca-602c-47dc-944d-374089f820ff" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Checkbox based on another option. Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FB8gxGlcDbouZvnMu6BFx%2Fimage.png?alt=media&amp;token=d1577e16-3711-4ee3-b476-44ccd84c865a" alt=""><figcaption></figcaption></figure>

### Layout

In the **Display** tab: set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the option takes, and **Option value orientation** (**Horizontal** or **Vertical**) to lay the values out in a row or stack them.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F31wfFSoVFa6CwfFs4Qi8%2Fimage.png?alt=media&amp;token=14dfdb8b-044d-46f5-9aaa-d31af9ba778d" alt=""><figcaption></figcaption></figure>

## Related guides

* [Radio Button](https://docs.optis.me/product-options/20-option-types/choice-list/radio-button)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options)
* [Limit Min/Max Selectors](https://docs.optis.me/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Dropdown menu

A **Dropdown menu** lets customers pick one value from a compact list - they click to open it, then choose.

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

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FamIcCoqh4y6sSHlJJrwx%2F15.png?alt=media&amp;token=c086275b-d85f-45d9-8af8-abb42ec81b6d" alt=""><figcaption></figcaption></figure>

## When to use a Dropdown menu

* **Fashion** - size, color, or fabric type.
* **Electronics** - storage capacity, color, or bundle options.
* **Personalized services** - engraving styles or packaging types.

## How to add a Dropdown menu option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Dropdown menu** under **Choice list** 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%2FWp4eSWiyS8IoyQ634ooB%2F1.png?alt=media&amp;token=08a837e7-30e9-4452-b8cc-e58618c278de" alt=""><figcaption></figcaption></figure>

### Step 2: Name it and add values

Enter the **Label on product** (e.g., "Select Size") and add the **Option values** (e.g., S, M, L, XL). Tick **Required field** if customers must choose before checking out, or **Hide option label** to hide the label.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FpaGwOEnkjE4wej4CcsHT%2F5.png?alt=media&amp;token=6d797a07-d958-4233-8c2e-872ec47385e4" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Dropdown menu works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FXcM6IsulJ5SrJkWxzT9M%2Fimage.png?alt=media&amp;token=86d25555-9091-46d3-b22a-d08992783a4d" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional. In the **Option values** table, click **Columns** to show **Add-on**, **Help text**, **SKU** or **Quantity** for each value:

* **Add-on** - charge extra for a value (**Extra fee**, Advanced plan and above) or link it to a Shopify variant (**Upsell product**, Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - a SKU for that value. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FhOuV1Aq1BgI73A3KtgMs%2Fimage.png?alt=media&amp;token=69ff7ff3-3b92-4038-ac20-9e0cb7838dfc" alt=""><figcaption></figcaption></figure>

### Default value

Toggle **Default** for the value that should be pre-selected when the customer opens the product page (e.g., default size "XS" for a dog's shirt). Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FL7KqurWn27TKdmjDOeeH%2F23.png?alt=media&amp;token=86c7667f-9496-458c-bcca-3420d451942d" alt=""><figcaption></figcaption></figure>

### Default text on dropdown

Show a placeholder such as "Select a size" or "Choose an option" before the customer picks a value.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FEWFpIkOSvCtwxEyGr9dS%2F10.png?alt=media&amp;token=94085a8f-7331-4bda-8a68-3b9258ac1767" alt=""><figcaption></figcaption></figure>

### Search bar

If the dropdown has many values (10-15 or more), enable a search bar so customers can find their choice faster - for example, a dropdown with 20+ fragrances.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQfwzyoJuROFymvV2zw3u%2F11.png?alt=media&amp;token=d626b970-8c38-4774-a2a2-1868fee8103f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FyVOv6QEIvhoxHDUqrReS%2FScreenshot%20-%202026-01-12T170753.187.png?alt=media&amp;token=34b4737c-8cff-461c-b0b8-4e08c9d2eadf" alt=""><figcaption></figcaption></figure>

### Quantity

Turn on the **Quantity** column so customers can pick several values (for example, several fragrances) and set how many of each, using **Min quantity** and **Max quantity**. Available on the **Platinum** plan and above. See [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options).

<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>

### Help text

Add a short note explaining what to choose, shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**. Available on the **Platinum** plan and above.

<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>

### Show or hide with Visibility (conditional logic)

Show or hide the Dropdown menu based on another option - for example, only show a "Customization" dropdown when the customer answers "Yes" to "Would you like to personalize this item?". Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F0aWe9T7GkrcwRabu14NK%2Fimage.png?alt=media&amp;token=0025dd0b-6eaa-4b44-80a8-237334b95891" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Dropdown menu takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F9U3dtq1LmntoeGF2jy72%2Fimage.png?alt=media&amp;token=e61299b1-7351-4bef-bf24-46d11ececa95" alt=""><figcaption></figcaption></figure>

## Related guides

* [Dropdown Menu with Thumbnails](https://docs.optis.me/product-options/20-option-types/choice-list/dropdown-menu-with-thumbnails)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Dropdown Menu with Thumbnails

A **Dropdown with thumbnail** is a dropdown menu that shows a small color block or image next to each value, so customers can recognize choices visually.

✨ [Demo store](https://optis-product-options-variant.myshopify.com/products/dropdown-menu-with-thumbnail?variant=51025988354326)

{% hint style="info" %}
**Plan:** **Dropdown with thumbnail** is available on the **Platinum** plan and above. On the Free plan you can still try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FWBJkOoyEQdtIK3eEVxg1%2F6.png?alt=media&amp;token=c544d88e-c7b0-45e7-b3f5-2444527a5d26" alt=""><figcaption></figcaption></figure>

## When to use a Dropdown with thumbnail

* **Fashion and decor** - shirt colors, fabric styles, or wall paint colors.
* **Custom gifts** - engraving icons or packaging patterns.
* **International products** - flag thumbnails for language or country options.

## How to add a Dropdown with thumbnail option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Dropdown with thumbnail** under **Choice list** 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%2FanNXZZtTIK9MPVpTqIfv%2F4.png?alt=media&amp;token=bec90b8c-bb0a-4af6-a63d-081da52bb432" alt=""><figcaption></figcaption></figure>

### Step 2: Name it, add values and assign thumbnails

Enter the **Label on product** (e.g., "Choose Color") and add the **Option values** (e.g., Pink, Blue, Marble). Tick **Required field** if customers must choose before checking out, or **Hide option label** to hide the label.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FdnQo2CUbXaJtwk5uRK3h%2F3.png?alt=media&amp;token=e8505519-a736-43ef-b973-b0018c9c5008" alt=""><figcaption></figcaption></figure>

Each value needs its own thumbnail - a color or an image:

* **Color thumbnail** - click the swatch button (**Edit swatch**) next to the value, open the **Color** tab, enter a hex code in **Color Picker (hex)** or pick a color, then click **Done**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FI5EMfMzjgfvFAruit2qt%2F13.png?alt=media&amp;token=8e564333-97bc-4c2a-aea8-bb31083822a7" alt=""><figcaption></figcaption></figure>

* **Image thumbnail** - click **Edit swatch**, open the **Image** tab, then use **Add images** to upload an image (JPG, JPEG, PNG, SVG or GIF, up to 5 MB) or select one from **OPTIS files** or **Shopify files**, then click **Done**. Recommended size: 50x50px or similar square dimensions.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FwQwHDN63hnQ10hxrrVQB%2F14.png?alt=media&amp;token=74b3e7bf-8cf5-4971-91b9-78f52f81dfb4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For a neat look, use the same thumbnail style (color or image) for every value of one dropdown.
{% endhint %}

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the dropdown with thumbnails works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FJmMzNJuoh0oq1vNL1cBw%2FScreenshot%20(75).png?alt=media&amp;token=2f62a36f-6faa-4d5f-96b0-b9851706554d" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional. In the **Option values** table, click **Columns** to show **Add-on**, **Help text**, **SKU** or **Quantity** for each value:

* **Add-on** - charge extra for a value (**Extra fee**, Advanced plan and above) or link it to a Shopify variant (**Upsell product**, Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - a SKU for that value. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQOKJQUvDACppXnCjGUim%2Fimage.png?alt=media&amp;token=c8728bde-9143-4340-8423-0fc772bc3725" alt=""><figcaption></figcaption></figure>

### Default value

Toggle **Default** for the value that should be pre-selected when the customer opens the product page (e.g., default to "White" if most customers choose that). Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FAUmpVMB9yMluL2dsxjO5%2F8.png?alt=media&amp;token=5193ebba-9342-4d59-b848-780b071c95f4" alt=""><figcaption></figcaption></figure>

### Default text on dropdown

Show a placeholder such as "Choose a style…" before the customer picks a value.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FEWFpIkOSvCtwxEyGr9dS%2F10.png?alt=media&amp;token=94085a8f-7331-4bda-8a68-3b9258ac1767" alt=""><figcaption></figcaption></figure>

### Search bar

If the dropdown has many values (10-15 or more), enable a search bar so customers can find their choice faster.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQfwzyoJuROFymvV2zw3u%2F11.png?alt=media&amp;token=d626b970-8c38-4774-a2a2-1868fee8103f" alt=""><figcaption></figcaption></figure>

### Quantity

Turn on the **Quantity** column so customers can pick several values (for example, several fragrances) and set how many of each, using **Min quantity** and **Max quantity**. Available on the **Platinum** plan and above. See [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options).

<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>

### Help text

Add a short note explaining what to choose, shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**. Available on the **Platinum** plan and above.

<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>

### Show or hide with Visibility (conditional logic)

Show or hide the option based on another option - for example, only show "Choose Material" when the customer answers "Yes" to "Customize Design". Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FX8hyy4OURDswkNjcrE5A%2Fimage.png?alt=media&amp;token=b868244e-e735-44f2-9353-e562e87b1060" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Dropdown with thumbnail takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F9U3dtq1LmntoeGF2jy72%2Fimage.png?alt=media&amp;token=e61299b1-7351-4bef-bf24-46d11ececa95" alt=""><figcaption></figcaption></figure>

## Related guides

* [Dropdown menu](https://docs.optis.me/product-options/20-option-types/choice-list/dropdown-menu)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Radio Button

A **Radio Button** shows a small circle next to each value; customers can pick only one. Selecting a new value automatically deselects the previous one.

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

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FfjwPjKOsocqsq0zUegE0%2F16.png?alt=media&amp;token=06e76eaf-d94f-4f17-aca1-53881516523e" alt=""><figcaption></figcaption></figure>

## When to use a Radio Button

* **Product variations** - one size, color, or material per product.
* **Shipping methods** - standard, express, or same-day delivery.
* **Surveys and forms** - a single yes/no question or a pick-one question.

## How to add a Radio Button option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Radio button** under **Choice list** 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%2FiqKfTpC6fwQQoDt6zDis%2F17.png?alt=media&amp;token=abeccd6e-6895-4328-ad1c-589397fdc933" alt=""><figcaption></figcaption></figure>

### Step 2: Name it and add values

Enter the **Label on product** (e.g., "Choose Scent") and add the **Option values** (e.g., Lavender, Vanilla, Eucalyptus). Tick **Required field** if customers must choose before checking out, or **Hide option label** to hide the label.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F1LkiI6q86R8FQ8IFL6FA%2F18.png?alt=media&amp;token=41f0fafd-8f2e-4f2c-98b7-c25e9deef235" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Radio Button works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FjINm0AwYpK1vDSPABVWG%2Fimage.png?alt=media&amp;token=a2724d59-45dc-4b95-a66d-b4ac6b7e2f27" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional. In the **Option values** table, click **Columns** to show **Add-on**, **Help text**, **SKU** or **Quantity** for each value:

* **Add-on** - charge extra for a value (**Extra fee**, Advanced plan and above) or link it to a Shopify variant (**Upsell product**, Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - a SKU for that value. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).
* **Quantity** - let customers choose how many of that value they want. Platinum plan and above. See [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FgCsW8TlbrWCHLxpri9k5%2Fimage.png?alt=media&amp;token=a5b03c6a-2e09-4c76-aa1b-18c3271eb677" alt=""><figcaption></figcaption></figure>

### Default value

Toggle **Default** for the value that should be pre-selected when the customer opens the product page. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FOzwKd6FYh4RPgPLjnhkN%2F19.png?alt=media&amp;token=acf61bb9-49be-4722-9704-4aa19179ad53" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to choose, shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**. Available on the **Platinum** plan and above.

<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>

### Show or hide with Visibility (conditional logic)

Show or hide the Radio Button based on another option. Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FvbzdjV02iwjnvYf7VG2T%2Fimage.png?alt=media&amp;token=c46cb31c-f01f-48bd-8cd7-746bd443aa7d" alt=""><figcaption></figcaption></figure>

### Layout

In the **Display** tab: set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the option takes, and **Option value orientation** (**Horizontal** or **Vertical**) to lay the values out in a row or stack them.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FXQ8YNWZ2InQx4dWD1YVQ%2Fimage.png?alt=media&amp;token=c0fefc6b-ff01-4743-aa7f-2631b0c901fc" alt=""><figcaption></figcaption></figure>

## Related guides

* [Checkbox](https://docs.optis.me/product-options/20-option-types/choice-list/checkbox)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Font Picker

A **Font Picker** lets customers choose a font style for their personalized text. Linked with a Text input option, the typed text updates live in the chosen font - a live preview that helps customers picture the result before adding to cart.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FWd360CxuEM4sr9AO2UIu%2F30.png?alt=media&amp;token=37ee89ae-34d0-46de-81c7-13c589a6e6ac" alt=""><figcaption></figcaption></figure>

✨ [Demo store](https://optis-product-options-variant.myshopify.com/products/font-picker-custom-backpack-copy?variant=51026044256534)

{% hint style="info" %}
**Plan:** **Font picker** is available on the **Advanced** plan and above. On the Free plan you can still try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

## When to use a Font Picker

* **Personalized text** - names, initials, or short engraved messages.
* **Custom apparel and gifts** - let customers preview their text in different fonts before buying.

## How to add a Font Picker option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Font picker** under **Choice list** 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%2F6V0iDQgxWTp3nYmZqUxK%2F25.png?alt=media&amp;token=8a6f85e8-5142-46fc-85f5-1acb7bd3d55c" alt=""><figcaption></figcaption></figure>

### Step 2: Name it and choose the fonts

Enter the **Label on product** (e.g., "Choose font"). Use **Label on cart** if the cart and order should show a different name.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F3DoQDk1r9BOVIqSz7Sdd%2F26.png?alt=media&amp;token=cf528eec-949b-4e55-a252-3b33a1f49f9e" alt=""><figcaption></figcaption></figure>

Under **Font picker settings**:

* **Font selection > All fonts** lets customers choose from all available Google Fonts.
* **Font selection > Selected fonts only** lets you pick the fonts yourself in **Font values** (at least one font must be selected).
* Tick **Enable search bar** to let customers search a long list of fonts.

{% hint style="warning" %}
**Note:**\
Currently, the app does not support uploading custom fonts directly. However, we do offer a custom solution - simply send us the font link, and our team will help you set it up.
{% endhint %}

**Display mode:** choose **Dropdown**, **Button (horizontal)** or **Button (vertical)**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F0BMLWynd29eNyugGHjbN%2Fimage.png?alt=media&amp;token=4c5f47cf-93a5-460a-9c3d-8831518eb41a" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Font picker works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FcXrtRKbLfwDRBNzMXKIV%2Fimage.png?alt=media&amp;token=5c0957f4-f215-4f52-ba02-19a2ffcc1c47" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional. In **Option settings**, click **Add-on** or **SKU** to charge extra for this option or give it a SKU:

* **Add-on** - **Extra fee** (Advanced plan and above) or **Upsell product** (Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FTpBQSP3QeN2NaCBJWLOW%2Fimage.png?alt=media&amp;token=4b9101a2-f2ea-4a17-bd70-0e0b17d3c2ea" alt=""><figcaption></figcaption></figure>

### Connect the Font Picker with a Text input

Link the Font Picker to a Text input option so the text customers type updates live in the selected font. Create the Text input option first - see [Text Input](https://docs.optis.me/product-options/20-option-types/text-input).

To link them, in **Font preview in text fields**, click **Select text fields** and choose the Text input option to connect.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FKnKYdUmHVL7fxUoHGi8H%2F3.png?alt=media&amp;token=17889d05-613d-45a6-8915-fe0f402da0c1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Note:**\
Text fields that are disabled in the list are already linked to another Font Picker. Each Text input can only be linked to **one** Font Picker at a time.
{% endhint %}

### Default value and placeholder

* **Placeholder text** - a short hint shown in the search field before a font is chosen. Available on every plan.
* **Default value** - the font that is pre-selected every time the customer opens the product page. Available on the **Advanced** plan and above.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQ6eEnGf0UcfhwhXiC3MT%2F28.png?alt=media&amp;token=fcc04beb-5bb9-496f-9d7c-e9d62070612a" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to choose. Choose how it's shown: **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<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>

### Show or hide with Visibility (conditional logic)

Show or hide the Font picker based on another option. Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F2tVNzT4vMYqydmXlphPT%2Fimage.png?alt=media&amp;token=868c48c5-cf9d-47b4-bbec-7cd1af5f6155" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Font Picker takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FHMo63vBVGLV6STtdCbC8%2Fimage.png?alt=media&amp;token=d620c395-2e13-4ef2-9268-7e0790b3cc83" alt=""><figcaption></figcaption></figure>

## Related guides

* [Text Input](https://docs.optis.me/product-options/20-option-types/text-input)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Swatch & Button

Swatch and Button options show the values as visual choices instead of a list. In the option editor they are listed under **Swatch**.

* [Swatch](https://docs.optis.me/product-options/20-option-types/swatch-and-button/swatch) - each value is a color or an image. Optionally show the value label below or next to the swatch, and use [Live mockup](https://docs.optis.me/product-options/advanced-setup/product-personalizer-live-mockup-settings) to preview the choice on the product.
* [Button](https://docs.optis.me/product-options/20-option-types/swatch-and-button/button) - each value is a clickable button, ideal for sizes, materials or service add-ons.

Both support **Add-on** prices, [SKU](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works), **Help text**, **Quantity** and limits on how many values can be selected. See [Limit Min/Max Selectors](https://docs.optis.me/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch).


# Swatch

A **Swatch** shows each value as a color block or a small image instead of a list, so customers can visually pick a color, style, or material.

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

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F7BRB03P4BGUQV9pCp4nH%2FScreenshot%20-%202026-01-13T140048.698.png?alt=media&amp;token=9d86e87a-7b38-4521-ab1d-53d2e5f3b20c" alt=""><figcaption></figcaption></figure>

## When to use a Swatch

* **Color selection** for apparel or accessories.
* **Material or texture choice** for furniture and home decor.
* **Visual personalization** - monogram styles, finishes, and more.

## How to add a Swatch option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Swatch** 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%2FoIXTMFhfDLgTfqfnHEVI%2F31.png?alt=media&amp;token=3101db53-36ed-4b23-8ea9-d1a361ed22da" alt=""><figcaption></figcaption></figure>

### Step 2: Name it, add values and set each swatch

Enter the **Label on product** (e.g., "Choose Color") and add the **Option values** (e.g., Red, Blue, Black). Tick **Required field** if customers must choose before checking out, or **Hide option label** to hide the label.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fiu0Qfpl9Z3TZqvn9TGBQ%2F32.png?alt=media&amp;token=97485db2-9734-46ef-a031-e0581ba0f0dd" alt=""><figcaption></figcaption></figure>

For each value, choose:

* A **color swatch** (solid color)

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLUsaa7t6uEz9oHacU5r8%2F33.png?alt=media&amp;token=b0a31800-9b33-4213-9885-97184ca12688" alt=""><figcaption></figcaption></figure>

* Or an **image swatch** (upload your own image)

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FnZ1WV5zGRxHkyWeSUtFY%2F34.png?alt=media&amp;token=d6f5b19e-8846-498c-a095-33fa600b0372" alt=""><figcaption></figcaption></figure>

Tick **Show option value label** if you also want the value's name shown next to the swatch, then choose a **Label position**: **Below the swatch**, **Below the swatch with a border**, **Next to the swatch**, or **Next to the swatch with a border**.

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Swatch works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FWbpesH9zaJIKrEFqL4NF%2Fimage.png?alt=media&amp;token=790efa1a-c942-4d47-b150-c9226495a81e" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional. In the **Option values** table, click **Columns** to show **Add-on**, **Help text**, **SKU** or **Quantity** for each value:

* **Add-on** - charge extra for a value (**Extra fee**, Advanced plan and above) or link it to a Shopify variant (**Upsell product**, Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - a SKU for that value. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FetVyUqYIA1vaTUTxYTal%2Fimage.png?alt=media&amp;token=971b4a36-931d-4c7b-90d4-9136879498b1" alt=""><figcaption></figcaption></figure>

### Default value

Toggle **Default** for the value that should be pre-selected when the customer opens the product page (e.g., "Black" selected automatically).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F25xfk9TniaMuaNTbOcT9%2F35.png?alt=media&amp;token=71accb5e-780b-4346-b62b-103e3b851ca1" alt=""><figcaption></figcaption></figure>

How it looks on your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FwLW2Tnirjy6i0Un6Ra2p%2F36.png?alt=media&amp;token=b2e4c19c-3e32-4f70-9c31-8dd89cf43810" alt=""><figcaption></figcaption></figure>

### Quantity

Turn on the **Quantity** column so customers can pick several values and set how many of each, using **Min quantity** and **Max quantity**. Available on the **Platinum** plan and above. See [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FFMS1G8lIQMtSVVLycr4F%2Fimage.png?alt=media&amp;token=099432ce-1246-41fa-a378-36f1fa98c3cc" alt=""><figcaption></figcaption></figure>

### Limit how many values can be selected

Set **Min** and **Max** to control how many values a customer can pick. If they pick fewer or more than allowed, OPTIS shows a message below the field, e.g. **Min selector: 2** or **Max selector: 5**. Available on the **Advanced** plan and above. See [Limit Min/Max Selectors](https://docs.optis.me/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fo8gUmmLkVwtvGRvJJOB0%2Fimage.png?alt=media&amp;token=706e0fdd-e085-4262-940e-a8c5bd037d47" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to choose, shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**. Available on the **Platinum** plan and above.

<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>

### Preview the choice on the product (live mockup)

Show customers what their selected swatch looks like on the product image, updated in real time. Available on the **Platinum** plan and above. See [Product Personalizer - Live Mockup Settings](https://docs.optis.me/product-options/advanced-setup/product-personalizer-live-mockup-settings).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FYqgYKLOJ417HCsS9E8pY%2F12.png?alt=media&amp;token=847e906d-cce5-4858-b0a4-95ee70380035" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Swatch based on another option. Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FU4KYCm0v7rrVW1pU5utd%2Fimage.png?alt=media&amp;token=37807e3e-ad52-4be7-986e-d8e7789bd990" alt=""><figcaption></figcaption></figure>

### Layout

In the **Display** tab: set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the option takes, and **Option value orientation** (**Horizontal** or **Vertical**) to lay the values out in a row or stack them.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FmHWCYhQUjXha32DZdtnD%2Fimage.png?alt=media&amp;token=e24dda62-882b-4294-a4ae-617a440ac129" alt=""><figcaption></figcaption></figure>

## Related guides

* [Button](https://docs.optis.me/product-options/20-option-types/swatch-and-button/button)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options)
* [Limit Min/Max Selectors](https://docs.optis.me/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch)
* [Product Personalizer - Live Mockup Settings](https://docs.optis.me/product-options/advanced-setup/product-personalizer-live-mockup-settings)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Button

A **Button** shows each value as a clickable button - customers select one with a single click, ideal for a short list like sizes or add-ons.

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

<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>

## When to use a Button

* **Sizes** - Small, Medium, Large.
* **Materials** - Leather, Canvas, Suede.
* **Extras** - add a dust bag, add a gift note.

## How to add a Button option

### Step 1: Add the 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: Name it and add values

Enter the **Label on product** (e.g., "Select Size") and add the **Option values** (e.g., Small, Medium, Large). Tick **Required field** if customers must choose before checking out, or **Hide option label** to hide the label.

<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>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Button works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FHP9qarx0npiqvD0Cfxt6%2Fimage.png?alt=media&amp;token=8249a858-fa88-4b17-b8d3-bca03100cd33" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional. In the **Option values** table, click **Columns** to show **Add-on**, **Help text**, **SKU** or **Quantity** for each value:

* **Add-on** - charge extra for a value (**Extra fee**, Advanced plan and above) or link it to a Shopify variant (**Upsell product**, Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - a SKU for that value. Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F2gib2rAmHHmapRN4IcU5%2Fimage.png?alt=media&amp;token=3abf10aa-eb9a-4538-8a6e-27856d73de03" alt=""><figcaption></figcaption></figure>

### Default value

Toggle **Default** for the value that should be pre-selected when the customer opens the product page (e.g., "S" selected automatically).

<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>

How it looks on 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>

### Quantity

Turn on the **Quantity** column so customers can pick several values and set how many of each, using **Min quantity** and **Max quantity**. Available on the **Platinum** plan and above. See [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FAE8dxcuhQl9H9mvwwpKQ%2Fimage.png?alt=media&amp;token=d8258caf-b570-4ae1-a84a-83c011aa1143" alt=""><figcaption></figcaption></figure>

### Limit how many values can be selected

Set **Min** and **Max** to control how many values a customer can pick. If they pick fewer or more than allowed, OPTIS shows a message below the field, e.g. **Min selector: 2** or **Max selector: 5**. Available on the **Advanced** plan and above. See [Limit Min/Max Selectors](https://docs.optis.me/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FB0K7SjKEv9fKvliTuDFZ%2Fimage.png?alt=media&amp;token=8960fcdc-0938-4522-957b-583cb910408f" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to choose, shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**. Available on the **Platinum** plan and above.

<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>

### Show or hide with Visibility (conditional logic)

Show or hide the Button based on another option. Available on the **Advanced** plan and above. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FbxMoD0d6ntEOfnsRTbDo%2Fimage.png?alt=media&amp;token=10dc9eb9-61c2-4b25-95de-0c8f248ead80" alt=""><figcaption></figcaption></figure>

### Layout

In the **Display** tab: set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the option takes, and **Option value orientation** (**Horizontal** or **Vertical**) to lay the values out in a row or stack them.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fdefi5ZItv88u1oWmRHWD%2Fimage.png?alt=media&amp;token=462eca8f-fac2-45a1-8813-869858781e4f" alt=""><figcaption></figcaption></figure>

## Related guides

* [Swatch](https://docs.optis.me/product-options/20-option-types/swatch-and-button/swatch)
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options)
* [Limit Min/Max Selectors](https://docs.optis.me/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Static text

Static text options display information on the product page. They do not collect anything from the customer. In the option editor they are listed under **Static text**.

* [Paragraph](https://docs.optis.me/product-options/20-option-types/markdown/paragraph) - a block of formatted text, links and images.
* [Heading](https://docs.optis.me/product-options/20-option-types/markdown/heading) - a title that separates sections of your options.
* [Divider](https://docs.optis.me/product-options/20-option-types/markdown/divider) - a line that visually separates groups of options.
* [Popup (Modal)](https://docs.optis.me/product-options/20-option-types/markdown/popup-modal) - a link that opens a pop-up with more information, such as a size guide (Platinum plan and above).


# Paragraph

A **Paragraph** shows formatted text on the product page - it doesn't collect anything from the customer. Use it to guide customers, explain a step, or add a note.

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

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F15lUcHVi4BtmDWNQ9vAC%2F11.png?alt=media&amp;token=d0bf32bc-42c8-4e88-a316-eba729058331" alt=""><figcaption></figcaption></figure>

## When to use a Paragraph

* Product descriptions, usage or care instructions.
* Important notes or recommendations.
* Explanations for other customization options.

## How to add a Paragraph option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Paragraph** under **Static text** 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%2FQ7a0hFXbQeqqhnesS7sD%2F45.png?alt=media&amp;token=9acaf706-86c4-4062-9cea-af9d357a0b49" alt=""><figcaption></figcaption></figure>

### Step 2: Write the content

Enter a **Label on product** to name the Paragraph in your option list - the label itself is not shown on the storefront, only your text is. Write your text in the **Content** editor - it supports formatting, links, tables and images. See [How to upload image in paragraph / pop-up modal?](https://docs.optis.me/product-options/faq/how-to-upload-image-in-paragraph-pop-up-modal).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FgBeoZbeShKGlmxuyhj9D%2F46.png?alt=media&amp;token=3258519f-eeca-42a6-b1d8-194f85dc5a4d" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Paragraph works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FGbrTl5r40xWWq7AeZcFC%2Fimage.png?alt=media&amp;token=d65ab1a0-81b5-498b-8f7b-76ecd2cbe735" alt=""><figcaption></figcaption></figure>

## Option settings

### Show or hide with Visibility (conditional logic)

Show or hide the Paragraph based on another option. Available on the **Advanced** plan and above. Note that a Paragraph can be shown or hidden by other options, but it cannot be used to trigger another option's visibility. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FoZ1Q52dsmX1punig5Myu%2Fimage.png?alt=media&amp;token=2a4c17ed-226f-41f9-8d01-c52abb29427b" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Paragraph takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FPrrlzFYYWsmbSKBOKT77%2Fimage.png?alt=media&amp;token=f73aafcf-259e-405c-ab07-40d13bd7c486" alt=""><figcaption></figcaption></figure>

## Related guides

* [Heading](https://docs.optis.me/product-options/20-option-types/markdown/heading)
* [Popup (Modal)](https://docs.optis.me/product-options/20-option-types/markdown/popup-modal)
* [How to upload image in paragraph / pop-up modal?](https://docs.optis.me/product-options/faq/how-to-upload-image-in-paragraph-pop-up-modal)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Heading

A **Heading** shows a bold line of text on the product page to separate sections or label a group of options - it doesn't collect anything from the customer.

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

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FhRDWzjR5bBl9wqUfnhQz%2Fheading.png?alt=media&amp;token=67bc9e9a-0946-4291-8994-ccc15bc7943a" alt=""><figcaption></figcaption></figure>

## When to use a Heading

* Group related customization fields under one title.
* Label steps in a multi-step configuration (e.g., "Step 1: Choose your Size").
* Draw attention to a section, such as "Gift Options".

## How to add a Heading option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Heading** under **Static text** 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%2FKcvvlbbaMdwhZcFMUA69%2Fadd-heading.png?alt=media&amp;token=dc9d53fb-5252-4f7e-a6c7-b7dbdc4af510" alt=""><figcaption></figcaption></figure>

### Step 2: Write the content

Enter a **Label on product** to name the Heading in your option list - the label itself is not shown on the storefront, only the heading text is. Enter your text in **Heading content** (e.g., "Step 1: Choose your Size"), then adjust **Size** (in px), **Text color** (**Theme color** or **Hex color**) and **Font weight** (**Bold** or **Normal**).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FsW5Fs9nLzyFY0mfKQ8AO%2Fheading%20content.png?alt=media&amp;token=f535af56-3b7e-489e-bbc8-142edeea5def" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Heading works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FJaP7aGGTIfSjl7meT7wD%2FScreenshot%20(69).png?alt=media&amp;token=050df2ac-be33-4bef-8799-1152999c6983" alt=""><figcaption></figcaption></figure>

## Option settings

### Show or hide with Visibility (conditional logic)

Show or hide the Heading based on another option. Available on the **Advanced** plan and above. Note that a Heading can be shown or hidden by other options, but it cannot be used to trigger another option's visibility. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FqUsXWe2A9qDqAsOFQHXL%2Fheadingcl.png?alt=media&amp;token=c5debf26-9bd1-4890-960e-9d9a7bc22dec" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Heading takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F24sj7Fct3KSsl60Wzzue%2Fimage.png?alt=media&amp;token=5a0bdb5f-f212-468f-a8f2-f24cb6e7ab01" alt=""><figcaption></figcaption></figure>

## Related guides

* [Divider](https://docs.optis.me/product-options/20-option-types/markdown/divider)
* [Paragraph](https://docs.optis.me/product-options/20-option-types/markdown/paragraph)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Divider

A **Divider** is a line that visually separates groups of options - it's not interactive and doesn't collect anything from the customer.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FWnMOxkeA4pcQr4qnQS25%2Fdivider%20example.png?alt=media&amp;token=91ee0183-0c41-46cb-8bfc-c920433e660b" alt=""><figcaption></figcaption></figure>

## When to use a Divider

* Separate personalization options from general options.
* Create visual sections, such as "Step 1 - Choose Size", "Step 2 - Choose Color".
* Improve clarity on products with many options.

## How to add a Divider option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Divider** under **Static text** 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%2FofilB7AnP1X0hvo9JHKy%2Fdivider.png?alt=media&amp;token=260e7742-627f-4b02-bd8d-ccf4ccd5dc35" alt=""><figcaption></figcaption></figure>

### Step 2: Style it

Enter a **Label on product** to name the Divider in your option list (the label is not shown on the storefront), then customize **Size** (line thickness in px), **Color** (**Theme color** or **Hex color**) and **Style** (**Dotted**, **Dashed**, **Solid**, **Double**, **Groove** or **Ridge**).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FMljgHc0dLMMHkemrl041%2Fimage.png?alt=media&amp;token=d1cc91c4-2e40-4e50-a95b-5445e21bd1c1" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Divider works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FeNJNUAbh8Q9d5mydHV4W%2Fimage.png?alt=media&amp;token=8187d291-14f3-4654-ab98-7a60c8344d94" alt=""><figcaption></figcaption></figure>

## Option settings

### Show or hide with Visibility (conditional logic)

Show or hide the Divider based on another option. Available on the **Advanced** plan and above. Note that a Divider can be shown or hidden by other options, but it cannot be used to trigger another option's visibility. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FDiW09VeCz7zgXuw2hZ9A%2Fdividercl.png?alt=media&amp;token=a8858811-7d2d-4b2a-a6bb-a8fe450ba226" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Divider takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F24sj7Fct3KSsl60Wzzue%2Fimage.png?alt=media&amp;token=5a0bdb5f-f212-468f-a8f2-f24cb6e7ab01" alt=""><figcaption></figcaption></figure>

## Related guides

* [Heading](https://docs.optis.me/product-options/20-option-types/markdown/heading)
* [Paragraph](https://docs.optis.me/product-options/20-option-types/markdown/paragraph)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Popup (Modal)

A **Pop-up modal** is a clickable text that opens a popup with more information - a size chart, care instructions, or a policy - without cluttering the product page. It doesn't collect anything from the customer.

{% hint style="info" %}
**Plan:** **Pop-up modal** is available on the **Platinum** plan and above. On the Free plan you can still try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

Example: "View Size Guide" opens a popup showing a size chart.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FM7PgZAAzHwmenQoTLVww%2Fchrome-capture-2026-08-07%20(1).gif?alt=media&amp;token=3095b08d-2aea-47c3-af92-e25437982902" alt=""><figcaption></figcaption></figure>

## When to use a Pop-up modal

* Size, frame or color guides.
* Personalization instructions or product care tips.
* Shipping and return policies, warranty or disclaimer info.

## How to add a Pop-up modal option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Pop-up modal** under **Static text** 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%2FwlOfxLwa1ReRjY7AOKex%2Fpopup.png?alt=media&amp;token=ddb8adf6-e783-4659-8850-f435f0fec95b" alt=""><figcaption></figcaption></figure>

### Step 2: Write the content

* **Label on product** - the clickable text that opens the popup (e.g., "View Care Instructions").
* **Title on pop-up** - shown at the top of the popup window.
* **Content** - your detailed content, including text, images, tables or bullet points. See [How to upload image in paragraph / pop-up modal?](https://docs.optis.me/product-options/faq/how-to-upload-image-in-paragraph-pop-up-modal).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FkYrpEg5gNklXM1Hsc3A6%2Fpopupedit.png?alt=media&amp;token=6506c59c-28d3-46d3-9198-2905c7635679" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Pop-up modal works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FyngSWvS5TH0H2hnA5hAa%2Fimage.png?alt=media&amp;token=87a1eeed-f9fa-4a73-b971-e7ba264d267f" alt=""><figcaption></figcaption></figure>

## Option settings

### Help text

Add a short note explaining what the popup is for. Choose how it's shown: **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FCWjdXn2CgFCBmkCzPZKi%2Fpopuphelptext.png?alt=media&amp;token=08d7946b-5c9a-49ef-b8b9-62b34c25e30e" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Pop-up modal based on another option. Available on the **Advanced** plan and above. Note that a Pop-up modal can be shown or hidden by other options, but it cannot be used to trigger another option's visibility. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FCRan0ZKErAWcRrpFZnqo%2Fpopupcl.png?alt=media&amp;token=35512322-4fdc-4c2a-b109-02614380009c" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the clickable Pop-up modal text takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FHtiPUdoWVObUjr1yIfep%2Fimage.png?alt=media&amp;token=18e23629-1cb7-4373-96de-c78b4f8629e0" alt=""><figcaption></figcaption></figure>

## Related guides

* [Paragraph](https://docs.optis.me/product-options/20-option-types/markdown/paragraph)
* [How to upload image in paragraph / pop-up modal?](https://docs.optis.me/product-options/faq/how-to-upload-image-in-paragraph-pop-up-modal)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)


# Others

These options cover special cases. In the option editor, File upload, Date & time and Color picker are listed under **Others**, and groups are created with **Add group**.

* [Color Picker](https://docs.optis.me/product-options/20-option-types/others/color-picker) - customers pick any color they like (Advanced plan and above).
* [File Upload](https://docs.optis.me/product-options/20-option-types/others/file-upload) - customers upload their own files, such as a logo or a photo (Advanced plan and above).
* [Date and Time Picker](https://docs.optis.me/product-options/20-option-types/others/date-and-time-picker) - customers choose a date, a time or a range (Advanced plan and above).
* [Option Group](https://docs.optis.me/product-options/20-option-types/others/option-group) - organizes several options under one collapsible title (Advanced plan and above).


# Color Picker

A **Color Picker** lets customers pick any color they want, using a color wheel or a hex code - not just from a predefined list.

{% hint style="info" %}
**Plan:** **Color picker** is available on the **Advanced** plan and above. On the Free plan you can still try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fva6kJaiIguE0HA5i0gnX%2Fcolorpicker1.png?alt=media&amp;token=e8429ee7-1bfb-43ec-a1c0-4d7b39f4d2fe" alt=""><figcaption></figcaption></figure>

## When to use a Color Picker

* Custom printed products (T-shirts, mugs).
* Personalized embroidery or engraving.
* Home decor with paint color options.

## How to add a Color Picker option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Color picker** under **Others** 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%2Fzf2eFOavj4Qr8Nnrbl0u%2Fcolorpicker2.png?alt=media&amp;token=9e52688a-4d9c-4027-bd97-6a20775cbb1c" alt=""><figcaption></figcaption></figure>

### Step 2: Name it

Enter the **Label on product** (e.g., "Pick Your Color"). Use **Label on cart** if the cart and order should show a different name.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FjkH7q81hNQKgHTQz0nMg%2Fcolorpicker3.png?alt=media&amp;token=fe92404a-06a3-4181-bb9c-5d19dd84cc63" alt=""><figcaption></figcaption></figure>

Tick any options below based on your needs:

* **Required field** if customers must select before adding to cart

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FW9hrxuG14DKnXoUYkApG%2Fcolorpicker5.png?alt=media&amp;token=334e777d-807f-4d2a-86f3-3e337c4c8ea1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FMgBzK4UE94p339Wbkbsi%2Fcolorpicker4.png?alt=media&amp;token=531a3e6b-afe2-46a2-908f-271beec9b855" alt=""><figcaption></figcaption></figure>

* **Hide option label** to hide the label above the color field

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F4WtH1u4R1RourEhi2tPL%2Fcolorpicker6.png?alt=media&amp;token=47470f96-6f24-4a92-bc8e-7d15744c4eae" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FeztL0HwZGfrOkFpXGU9A%2Fcolorpicker7.png?alt=media&amp;token=693cf78d-8dc3-42cb-bf85-50b462c58672" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Color Picker works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FleGrEQCNl2BLDkQZ83oN%2Fimage.png?alt=media&amp;token=977b9293-5b72-47f9-be43-37158b3eb8e7" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional.

* **Add-on** - charge extra for this option (**Extra fee**, Advanced plan and above) or link it to a Shopify variant (**Upsell product**, Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FqCSbfpewrdO5vQzHa8j8%2Fcolorpicker8.png?alt=media&amp;token=d4ab88fd-58df-4fac-bc90-ebda5dc550ab" alt=""><figcaption></figcaption></figure>

### Placeholder

A short hint shown in the color field before the customer chooses a color.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FC4TP6PNmYKrx0UOkzOey%2Fimage.png?alt=media&amp;token=462119ff-0c4c-4901-87ad-17e4826a9874" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note explaining what to choose, shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F71qB09U7MBH80jP7oKMC%2Fcolorpicker9.png?alt=media&amp;token=0ad47fd0-27d7-4759-a60e-846fd1fbf80f" alt=""><figcaption></figcaption></figure>

Example of Help text shown as a Tooltip on the storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FVEfRY862yS69WWaNgoxt%2Fcolorpicker10.png?alt=media&amp;token=0c6bba65-d6fc-4e2c-ac6a-44b641192126" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Color Picker based on another option. Available on the **Advanced** plan and above. Note that a Color picker can be shown or hidden by other options, but it cannot be used to trigger another option's visibility. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FdS1Hv1rXGTtGRXJJj03g%2Fcolorpicker12.png?alt=media&amp;token=0c02a5f1-c18b-4d15-886b-8825b8176c26" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Color Picker takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F3e2m90Gby1pg6xsNbXtU%2Fimage.png?alt=media&amp;token=da97b178-0e84-4e88-8188-ddef7da187ec" alt=""><figcaption></figcaption></figure>

## Related guides

* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)
* [Settings overview](https://docs.optis.me/product-options/customize-design/settings-overview)


# File Upload

A **File Upload** lets customers upload their own file directly on the product page - a photo, a logo, or another file for a personalized product.

{% hint style="info" %}
**Plan:** **File upload** is available on the **Advanced** plan and above. On the Free plan you can still try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FiKSMIpQCRI66q6a1A5fO%2Ffileupload1.png?alt=media&amp;token=a0732b72-01ac-4de7-958c-8384ae985d4d" alt=""><figcaption></figcaption></figure>

## When to use a File Upload

* Custom products - artwork for personalized t-shirts, mugs, phone cases.
* Print services - business cards, resumes, banners.
* Design orders - personal images or brand logos for marketing materials.

## How to add a File Upload option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **File upload** under **Others** 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%2FXfrJ2TC1KMmPTG5hBblI%2Ffileupload2.png?alt=media&amp;token=8b464a9e-6c17-46a1-9cc9-620e38315c31" alt=""><figcaption></figcaption></figure>

### Step 2: Name it

Enter the **Label on product** (e.g., "Upload Your Photo"). Use **Label on cart** if you want a different name in the cart and in the order.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FXhF3JrxcBaiS8C7VlWt9%2Ffileupload3.png?alt=media&amp;token=551f5dd7-8de9-45de-89b5-081c893816ee" alt=""><figcaption></figcaption></figure>

Tick any options below based on your needs:

* **Required field** if customers must select before adding to cart

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FjipIFmnFWI9elvXbDHHB%2Ffileupload4.png?alt=media&amp;token=6067b8b6-e911-47fd-a84b-613e9c319531" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FrfVfMZApuNKqbwd5DJmG%2Ffileupload5.png?alt=media&amp;token=d7a35759-2f40-480c-bfc8-04783bbdef44" alt=""><figcaption></figcaption></figure>

* **Hide option label** to hide the label above the upload button

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FB9fPASY54qGVPkC7LtM5%2Ffileupload6.png?alt=media&amp;token=48aad15f-e79c-4e9f-a358-6b008a6f46b9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F67VqFYJt5y0Dwj7LL3At%2Ffileupload7.png?alt=media&amp;token=f6731c52-3b26-4c73-a810-9e00009410b1" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the File Upload works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fd7078Sw0SGeTUNNuKIKq%2Fimage.png?alt=media&amp;token=d6a90494-9e1e-4265-a05c-98acf41d21f4" alt=""><figcaption></figcaption></figure>

## Option settings

Set only what you need - all of the settings below are optional.

* **Add-on** - charge extra for this option (**Extra fee**, Advanced plan and above) or link it to a Shopify variant (**Upsell product**, Platinum and above). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
* **SKU** - Advanced plan and above. See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FD0FlN5bGNhmosEJWIBsm%2Ffileupload8.png?alt=media&amp;token=1c024664-2bbe-41e6-ad28-cf967405ac45" alt=""><figcaption></figcaption></figure>

### File settings

Control what customers can upload:

* **Accepted file types** - **All files (any extension)**, **Images** (jpeg, jpg, png, svg, tiff, tif), **Documents** (pdf, doc, docx, html, htm, xls, xlsx, txt) or **Custom extensions** (type each extension in **Custom file extensions**).
* **Max number of files** - up to **5** files on Advanced, up to **20** on Platinum and Unlimited.
* **File size** - no size setting on the option itself; the maximum per file is **20 MB** on Advanced and **50 MB** on Platinum and Unlimited. The limit is shown under the upload button, and customers see an error if a file is too large.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FAnmVdnoRPMFFXOdM4PG8%2Ffileupload9.png?alt=media&amp;token=91272b9d-79e0-4cdf-94e2-87237060e530" alt=""><figcaption></figcaption></figure>

### Help text

Add a short note such as "High-resolution files only" or "Accepted formats: JPG, PNG", shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FW41slHnarOPXHVsBXMJC%2Ffileupload10.png?alt=media&amp;token=48da4b91-2ac5-4f37-aad5-57077d52aecd" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the File Upload based on another option, for example only when the customer chooses "Add image". Available on the **Advanced** plan and above. Note that a File upload option can be shown or hidden by other options, but it cannot be used to trigger another option's visibility. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F4rYqgywNX7oAWaNZoq6n%2Ffileupload11.png?alt=media&amp;token=e009a14a-ce58-4e22-a084-630b570b4690" alt=""><figcaption></figcaption></figure>

### Preview the upload on the product (live mockup)

Let customers preview their uploaded image or logo directly on the product in real time before adding it to the cart. Available on the **Platinum** plan and above. See [Product Personalizer - Live Mockup Settings](https://docs.optis.me/product-options/advanced-setup/product-personalizer-live-mockup-settings).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FG93Pq2prWTUljlo92JDo%2Ffileupload12.png?alt=media&amp;token=c484eaf5-6b6d-433f-939b-552a7b01c809" alt=""><figcaption></figcaption></figure>

### How the upload area looks

This is a store-wide setting. Go to **Settings > General Settings > Option type setting > File upload display** and choose:

* **1 file per row** (default) - a drag-and-drop area with **Choose file** and "Or drop file to upload"; each uploaded file is listed on its own row.
* **Multiple files per row** - a **Choose file** button; uploaded files are shown side by side.

You can rename the **Choose file** and drop-zone texts in **Settings > Translation Texts**. See [Translate the "Choose File" of File Upload](https://docs.optis.me/product-options/customize-design/translate-the-choose-file-of-file-upload).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F0ajkDgWXBOADk9PZuQQ9%2Fimage.png?alt=media&amp;token=214afb70-07a7-45ac-ade0-8d5314faa55f" alt=""><figcaption></figcaption></figure>

## Related guides

* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)
* [Product Personalizer - Live Mockup Settings](https://docs.optis.me/product-options/advanced-setup/product-personalizer-live-mockup-settings)
* [Translate the "Choose File" of File Upload](https://docs.optis.me/product-options/customize-design/translate-the-choose-file-of-file-upload)


# Date and Time Picker

A **Date & time** option lets customers choose a date, a time, or both from a calendar and clock popup - perfect for appointments, deliveries, or any time-sensitive order.

{% hint style="info" %}
**Plan:** **Date & time** is available on the **Advanced** plan and above. On the Free plan you can still try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F1ZNSj0pQtJXX3f1REOpJ%2Fd%26t.png?alt=media&amp;token=3ab05c33-04cb-4fa7-872b-e59277262fd0" alt=""><figcaption></figcaption></figure>

## When to use a Date & time picker

* Choosing a delivery date for cakes, flowers, or gifts.
* Booking a pickup time for a customized order.
* Scheduling a service appointment (spa, photography, consulting).
* Reserving a seat or slot for an event.

## How to add a Date & time option

### Step 1: Add the option

Open **1. Add options**, click **Add option**, tick **Date & time** under **Others** 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%2FhlwPuGPGLVfC0gm3ETEk%2Fd%26t1.png?alt=media&amp;token=73834f89-11c1-4000-baa3-d60f1fcfdff1" alt=""><figcaption></figcaption></figure>

### Step 2: Set up the picker

Enter the **Label on product** (e.g., "Select Your Delivery Date"). Tick **Required field** if customers must choose a date before adding to cart, and **Hide option label** if you don't want to show the label.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fhzjs5zKEOBhrIbWgjNQ1%2Fd%26t2.png?alt=media&amp;token=de2a246f-e8af-4027-b8fe-5125a31fdc6c" alt=""><figcaption></figcaption></figure>

* **Date & time picker** or **Date & time range** - a single date/time, or a start and end (a range, for example a rental period). **Time only** is not available in range mode.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F7pjXIyjgrCScb1A1NQXo%2Fd%26t3.png?alt=media&amp;token=1b33eeae-689a-4df2-ae26-4e37d0c229e0" alt=""><figcaption></figcaption></figure>

* **Selectable dates** - tick the weekdays customers can select. For each, choose **All day**, or set a **Start time** and **End time**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FbLOpYw3kQSxprFI4B5RE%2Fd%26t4.png?alt=media&amp;token=b8c130f0-1750-4900-94a3-1b86d86d6895" alt=""><figcaption></figcaption></figure>

* **Display date/time** - what customers select (**Date & time**, **Date only** or **Time only**) and how it is written: **Time format** (**12-hour** or **24-hour**) and **Overall format** (**DD-MM-YYYY**, **MM-DD-YYYY**, **30th January, YYYY**, or **January 30th, YYYY**). The **Example** shown previews the result.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FAXmsMANEv2SZjCRGXoHm%2Fd%26t5.png?alt=media&amp;token=8b783331-26e9-400a-a47f-d1c86b64e22c" alt=""><figcaption></figcaption></figure>

* **Deactivated dates** - block dates or times customers cannot choose: **Cut-off date/time** (a value and a unit, so orders need advance notice), **Disable specific dates** (e.g., holidays), **Disable date ranges** (a closure period), or **Disable past dates**. These three are not available when customers select **Time only**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fg0AMgoopZlsMBsoqGY8n%2Fd%26t6.png?alt=media&amp;token=c266a822-3e0f-48ee-b4c5-665291cbbf07" alt=""><figcaption></figcaption></figure>

### Step 3: Save and test

Click **Save**, then open the product page on your store to check that the Date & time picker works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fl0vWjlnzB0kYMN6DJ4iJ%2Fimage.png?alt=media&amp;token=088d482c-866c-4ed1-890c-a0198d9ca277" alt=""><figcaption></figcaption></figure>

## Option settings

{% hint style="info" %}
The Date & time option does not support Price add-on or SKU.
{% endhint %}

### Help text

Add a short description of the option, shown as a **Tooltip**, **Below the option title**, **Beside the option title**, or **Below the option**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fej7wND4EO1c6Tnj2xrop%2Fd%26t9.png?alt=media&amp;token=b9fc8c18-8a3c-4ea2-9dfc-2cee8ea5761e" alt=""><figcaption></figcaption></figure>

### Placeholder

A short hint shown inside the field to guide customers on what to enter.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQuPOFaTNrfcSrVdRewuk%2Fd%26t8.png?alt=media&amp;token=ee41ff23-6410-40dd-a7e3-a8f4ca27674e" alt=""><figcaption></figcaption></figure>

### Show or hide with Visibility (conditional logic)

Show or hide the Date & time option based on another option. Available on the **Advanced** plan and above. Note that a Date & time option can be shown or hidden by other options, but it cannot be used to trigger another option's visibility. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FXvZB9oefyJM82d93VqFN%2Fd%26t7.png?alt=media&amp;token=b24509b1-cd4a-4994-9b17-d3ad7509bf14" alt=""><figcaption></figcaption></figure>

### Option width

In the **Display** tab, set **Option width** (**25%**, **33%**, **50%**, **67%**, **75%** or **100%**) to control how much horizontal space the Date & time option takes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FGJ9b1YMm11K9UwPipQBU%2Fimage.png?alt=media&amp;token=e27f8cf1-785a-4f08-ac06-c6b2239d09a5" alt=""><figcaption></figcaption></figure>

### Error messages

If a customer picks a time outside the allowed range, or an invalid date range, the storefront shows an error message. Change the wording in **Settings > Translation Texts > Default text customization > Product page** (**Invalid time** and **Invalid date range**).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FSn0ddiGW5EnhzXrnibMG%2Fimage.png?alt=media&amp;token=f8aff255-d5d8-4787-9fe6-9ac88766b554" alt=""><figcaption></figcaption></figure>

## Related guides

* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)
* [Settings overview](https://docs.optis.me/product-options/customize-design/settings-overview)


# Option Group

An **Option Group** is a container that holds several options under one title. Customers can click the title to expand or collapse the options inside - handy for products with many customization fields.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FNzNKhRlzmov9wCVTzXIx%2Fimage.png?alt=media&amp;token=5a4bf616-12e7-4cbc-ad76-ac3a1e5113e4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Plan:** Option groups are available on the **Advanced** plan and above. On the Free plan you can still try them on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

✨ [Demo store](https://optis-product-options-variant.myshopify.com/products/custom-backpack-option-group?_pos=1&_psq=option+group&_ss=e&_v=1.0)

## When to use an Option Group

* Structure a long option set into clear sections.
* Hide optional or advanced settings until the customer needs them.
* Keep required, frequently used options open and visible by default.

## How Option Groups appear on the storefront

{% embed url="<https://jam.dev/c/0fe7df8d-427c-4221-bed5-864d011b209c>" %}

## How to add an Option Group

### Step 1: Create the group

In **1. Add options**, click **Add group** (or **Add group after** from an option's menu). The group is added as **Untitled Group**, and its settings open in the editor panel with **Content** and **Display** tabs.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FhuGnnpVlwqqhxLmDdY4H%2Fadd%20group.png?alt=media&amp;token=4ea78376-deae-4e11-a2dc-dc780667f18e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Groups can't be nested - you can't add a group inside another group.
{% endhint %}

### Step 2: Configure the group

{% stepper %}
{% step %}

#### In the **Content** tab, set the group label

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLQ6VzD3fCjpdCso2VXGu%2Fimage.png?alt=media&amp;token=1699b41b-8730-41c1-a059-cffe8df17445" alt=""><figcaption></figcaption></figure>

**Label on product** - type the name (max 250 characters). It is shown on the product page as a clickable header. You can also click the group name at the top of the panel to rename it:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FueboT71UqDEJyaUGbiLh%2Fgroup%20label.png?alt=media&amp;token=753ba3c7-b74c-457f-a21c-21e6517dab46" alt=""><figcaption></figcaption></figure>

#### In the **Display** tab, choose the Display type and add Visibility

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FxHySsi19cZOjBqeifIxq%2Fdisplay%20group.png?alt=media&amp;token=3495b995-dc04-476b-9bb5-8d9367617ec7" alt=""><figcaption></figcaption></figure>

**Display type** - under **Default state when page loads**, choose:

* **Expand** - the group is open by default, and all options inside are immediately visible. Recommended for required or frequently used options.
* **Collapse** - the group is hidden by default; customers click the title to view the options. Recommended for optional or advanced settings.

**Visibility (optional)** - show or hide the whole group based on another option, useful for revealing extra options only when needed. Options inside the group can still have their own, independent Visibility rules. See [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics).
{% endstep %}

{% step %}

#### Click the back arrow at the top of the panel to finish

{% endstep %}
{% endstepper %}

### Step 3: Add options to the group

1. Continue adding options **to this group** with **Add option in group** (use **Add option after group** to add an option outside of the group).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fxk9BDqqQ4cA3PwVOiPni%2Fadd%20option%20in%20group.png?alt=media&amp;token=49580821-1a3c-4c39-9444-0fbbef95b8a3" alt=""><figcaption></figcaption></figure>

2. Select the option type you want to create (checkbox, text box, etc.).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FZXPhD8LtPwijHtrnbFgu%2Fadd%20options.png?alt=media&amp;token=4f337fba-8e7c-4131-acf6-fcd157e7b530" alt=""><figcaption></figcaption></figure>

3. Configure the option as usual and click **Save**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FUkWBUon1ziSQsSbbZp0E%2Fsave.png?alt=media&amp;token=e3863dfa-0d49-4b0f-8a78-bc4364986dd8" alt=""><figcaption></figcaption></figure>

You'll now see the option inside the group, and a live preview on the right showing how the group expands and collapses.

{% hint style="info" %}
Already have separate options you want to move into a new Option Group? Drag and drop them here:
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FK1S8TvC2bhFNK9EWFrGk%2FScreenshot%20at%20Aug%2008%2010-27-29.png?alt=media&amp;token=09738989-4bde-40a6-add5-aa941b12a77e" alt=""><figcaption></figcaption></figure>

### Step 4: Apply to products and save

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FjkOCAV0QABmqYCLTgyhj%2Fk.png?alt=media&amp;token=a45404e8-7a95-4dcd-a186-b2574f0ee62e" alt=""><figcaption></figcaption></figure>

## Related guides

* [How to set up Conditional logics?](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics)
* [Assign an option set to products and customers](https://docs.optis.me/product-options/getting-started/assign-option-sets-to-products-and-customers)


# Show updated total price with add-ons

{% hint style="info" %}
This feature is available on the **Advanced** plan and above. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

**Installing the 'Price increased with price add-ons' advanced feature help:**

* 💡 Displays updated pricing in real time when customers select paid add-ons.
* 🛍️ Helps customers understand the total cost clearly right on the product page.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FaVKbcnb0u9s9vn1XYX1M%2Fimage.png?alt=media&amp;token=0a81b65c-6662-437b-9c96-b5b14e960891" alt=""><figcaption></figcaption></figure>

### **How to make it work in your store?**

**Step 1: Turn on the feature**

Go to **Advanced features**, find **Show update total price with addons** and click **"Click to turn on"**

**Step 2: Contact us to help you install**

This advanced setup requires custom code configuration on our end. **Please contact our support team for assistance.**


# Shorten file upload display on cart/checkout

{% hint style="info" %}
This feature is available on the **Advanced** plan and above. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

**Installing the 'Shorten file upload display on cart/checkout' advanced feature help:**

* 🖼️ Shows a small preview of the uploaded file in the cart.
* 🔗 Replaces the plain file link with a more visual and useful display.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FocY87pg8RUpVRqNw6HOB%2Fimage.png?alt=media&amp;token=d9a14880-c564-4ffd-b090-ea76cc0db7ae" alt=""><figcaption></figcaption></figure>

### How to make it work in your store? <a href="#id-3-how-to-make-it-work-in-your-store" id="id-3-how-to-make-it-work-in-your-store"></a>

**Step 1: Turn on the feature**

Go to **Advanced features**, find **Shorten file upload display on cart/checkout** and click **"Click to turn on"**

**Step 2: Contact us to help you install**

This advanced setup requires custom code configuration on our end. **Please contact our support team for assistance.**


# Work with your cart drawer / ajax cart

**Installing the 'Work with your cart drawer/ajax cart' advanced feature help:**

* Lets customers see their selected options in the mini-cart or side cart drawer, **when click on add to cart**
* Helps them double-check their choices before checkout.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FYgpCTk6agBZk7tkUXkwH%2Fimage.png?alt=media&amp;token=06934f63-8e5e-4528-be27-fc7fa41b0fbb" alt=""><figcaption></figcaption></figure>

### **How to make it work in your store?**

This installation can only work if your theme already has a mini-cart, cart slider, or ajax cart feature. If your theme does not have one, this setting will not apply.

**Step 1: Enable the widget**

* Go to **Advanced features**, find **Work with your cart drawer / ajax cart** (the page is titled **Display Options on Mini-cart and Cart Slider**) and turn on the toggle. This feature is available on every plan.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F4IapVqnsQw786iSJKND2%2Fimage.png?alt=media&amp;token=55a198dd-245c-4e69-a6ac-e3cdb6e23812" alt=""><figcaption></figcaption></figure>

**Step 2: Contact Support**

After enabling the toggle, please reach out to our support team. We will assist you for free to properly install and configure it into your store’s cart within one working day.


# Edit option on cart page

{% hint style="info" %}
This feature is available on the **Platinum** plan and above. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

**Installing the 'Edit option on cart page' advanced feature help:**

* ✏️ Customers can edit selected options directly in the cart.
* 🔄 No need to remove and re-add the product.
* 🎯 Makes shopping faster and more flexible.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FcUpL6SEJua61lfwfF6cR%2Fimage.png?alt=media&amp;token=1460d765-4c0a-4e91-9b3d-d049932eb4b7" alt=""><figcaption></figcaption></figure>

### **How to make it work in your store?**

This setup involves some coding and may be a bit complex if you're not familiar with technical tasks. Please contact us via live chat for free installation. We will complete it for you within 1 working day

**Step 1: Turn on the feature**

Go to **Advanced features**, find **Edit option on cart page** and click **"Click to turn on"**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FfAYpnZAF1ZxIG1Q6MBmt%2Fimage.png?alt=media&amp;token=5141d6ae-c339-4bb9-b75e-b2e2311259c7" alt=""><figcaption></figcaption></figure>

**Step 2: Contact us to help you install**

This advanced setup requires custom code configuration on our end. **Please contact our support team for assistance.**

You can rename the **Edit options**, **Update** and **Cancel** texts in **Settings > Translation Texts > Default text customization > Cart page**, and change the color of the edit button in **Settings > Design Settings > Color**. See [Settings overview](https://docs.optis.me/product-options/customize-design/settings-overview).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FmuWzKX9drSvY4c7LRURp%2Fimage.png?alt=media&amp;token=8734eaa7-a17a-4b1d-ac2a-a570176f9768" alt=""><figcaption></figcaption></figure>


# Show options on featured products

**Installing the 'Show options on featured products' advanced feature help:**

* ✅ Shows options on featured product, which shows on the homepage, collection pages, or featured product blocks.
* 🛒 Lets customers select options and buy product without visiting the product detail page.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F9jxDO6r3aLMWf9LJTFS0%2Fimage.png?alt=media&amp;token=626c998e-bf34-4f97-a28e-0e93a7d002b1" alt=""><figcaption></figcaption></figure>

### **How to make it work in your store?**

**Step 1: Turn on the feature**

Go to **Advanced features**, find **Show options on featured products** and click **"Click to turn on"**

**Step 2: Contact us to help you install**

This advanced setup requires custom code configuration on our end. **Please contact our support team for assistance.**


# Sync price list with market prices

If you sell in several countries with Shopify **Markets** and use price lists, run this sync so that the price of your add-ons follows the prices of each market. It makes sure price add-ons reflect the accurate market rates after price changes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FJjtngfPnIDrUD6nCvoo2%2Fimage.png?alt=media&amp;token=4c537aa8-a54c-411f-b4e5-a1af42a6306f" alt=""><figcaption></figcaption></figure>

## How to sync

1. In the app, go to **Advanced features**.
2. Find the card **Sync price list with market prices** and click **Sync**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FFpiyUQwqWQQKshIusY84%2Fimage.png?alt=media&amp;token=16bdfb77-1cea-4035-bed3-6dcb30f765da" alt=""><figcaption></figcaption></figure>

1. Wait for the message:
   * **Price lists synchronized** - your markets and price lists were updated.
   * **No additional markets or price lists to sync** - nothing new was found in your store.
   * **Price lists failed to sync** - try again, or contact support.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FtJuW2JuWzy0U6Bj0rdy4%2Fimage.png?alt=media&amp;token=1a8a051e-33fd-40fb-9637-ec8516a27ded" alt=""><figcaption></figcaption></figure>

OPTIS reads the markets and price lists of your store from Shopify (the market currencies and the price adjustments of each price list) and saves them, so that add-on prices follow the prices of your markets.

## When to sync again

Click **Sync** again whenever you:

* create a new market or price list,
* change the currency or the price adjustment of a price list, or
* change the market prices of your products.

{% hint style="info" %}
The sync is available on every plan, but it is only useful if you use price add-ons (an **Advanced** plan feature). See [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option).
{% endhint %}


# Notification

Show your customers' selected OPTIS options directly in Shopify's own **order confirmation email**, **packing slip**, and **staff order notification** — so everyone fulfilling or reading the order sees exactly what was chosen, without opening the app.

* 📧 Shows selected options in the order confirmation email.
* 🧾 Includes them on the packing slip for accurate order fulfillment.
* 🔔 Includes them on the staff order notification email.
* ✅ Helps reduce packing errors and boosts customer confidence.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FWLEgJpUG3cHBQE29WlKO%2Fimage.png?alt=media&amp;token=0a5e1a46-1a4a-4854-a5f7-e816af0847d3" alt=""><figcaption></figcaption></figure>

## Where to find it

In the app's left menu, go to **Orders > Notification** tab. Pick a section from the list on the left: **Order confirmation email**, **Packing slip**, or **Staff notification email**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F9DORXQzELEOlnEyoj7vD%2FScreenshot%20(5).png?alt=media&amp;token=f939d79d-4eae-4c0d-ab0c-9a55c9b0f793" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This feature is included on every plan, including **Free**.
{% endhint %}

## How to make it work in your store

Shopify's notification templates live outside the app, so each section needs a one-time, one-line paste into the matching Shopify template. Every section already shows you the exact snippet and a **Copy** button — you don't need to write any code yourself, just paste it at the marker shown. This setup involves some coding and may be a bit complex if you're not familiar with technical tasks; contact us via live chat and we'll complete it for you for free within 1 working day.

### 1. Order confirmation email

{% stepper %}
{% step %}

#### Open the template

Click the **Order Confirmation Email Template** link (opens Shopify's own template editor).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F9KVeRk71MDsEKoAb19in%2Fimage.png?alt=media&amp;token=eab60990-0d0f-4ea3-8056-668f48c00fe0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Paste the Store-confirm snippet

Find `{{ line.variant.title }}` in the HTML Body and paste the **Store-confirm** snippet right after `{% endif %}`.

{% code title="Store-confirm" %}

```liquid
<div class='bss-po-email'>
  {% for property in line.properties %}
    {%- unless property.first contains '__bss_po_' -%}
      {% assign bss_p_first = property.first | replace_first: '_', '' %}
      {{ bss_p_first }}: {{ property.last }}<br/>
    {% endunless %}
  {% endfor %}
</div>
```

{% endcode %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLA0rJeGFcw0EBfw2f7Pe%2Fimage.png?alt=media&amp;token=69945f29-74c2-4040-a6be-c76d325dc09d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Paste the Store-confirm-step3 snippet

Find `{{ component.quantity }}` in the HTML Body and paste the **Store-confirm-step3** snippet right after `<br>`.

{% code title="Store-confirm-step3" %}

```liquid
<div class='bss-po-email'>
  {% for property in component.properties %}
    {%- unless property.first contains '__bss_po_' -%}
      {% assign bss_p_first = property.first | replace_first: '_', '' %}
      {{ bss_p_first }}: {{ property.last }}<br/>
    {% endunless %}
  {% endfor %}
</div>
```

{% endcode %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FxnXB9M1PuH8xnAlsXmsC%2Fimage.png?alt=media&amp;token=f183f8a2-1427-4617-9b14-689f47eef295" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Save

Save the template and wait 30 seconds. Done!

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FFlKtLry0DyjP4qUcvtbX%2Fimage.png?alt=media&amp;token=16ce80a3-fc8a-4625-91a4-ac7c85d301fe" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 2. Packing slip

{% stepper %}
{% step %}

#### Open the template

Click the **Packing Slip Template** link.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F5d6XQdoknkErwkRJp3nS%2Fimage.png?alt=media&amp;token=40ddea76-3868-4497-98fd-bb5ba583bc98" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Paste the Store name snippet

Find `{{ line_item.sku }}` in the HTML Body and paste the **Store name** snippet right after the `</p>` tag.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FU2jKZJisxnEKWzLGlZ5T%2Fimage.png?alt=media&amp;token=4a0f97bd-6d68-4746-9202-ad0341dda56a" alt=""><figcaption></figcaption></figure>

{% code title="Store name" %}

```liquid
<div class='bss-po-packing-slip'>
  {% for property in line_item.properties %}
    {%- unless property.first contains '__bss_po_' -%}
      {% assign bss_p_first = property.first | replace_first: '_', '' %}
      {{ bss_p_first }}: {{ property.last }}<br/>
    {% endunless %}
  {% endfor %}
</div>
```

{% endcode %}
{% endstep %}

{% step %}

#### Save

Save the template and wait 30 seconds. Done!

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FkaYNdafbtZ1K64vre6Mp%2Fimage.png?alt=media&amp;token=9286f3f0-20e2-4b9b-ab2e-323bd90fcc28" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 3. Staff notification email

{% stepper %}
{% step %}

#### Open the template

Click the **Staff order notification** link.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FwWsN5Vxk4jFe8XEv3g5Q%2Fimage.png?alt=media&amp;token=27f58949-50cd-405b-84c3-5f53c4fc416f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Paste the Staff notification snippet

Find `{{ line.sku }}` in the HTML Body and paste the **Staff notification snippet** right after the `</p>` tag.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FMrbAiQZ4BEYfPGNGQqJf%2Fimage.png?alt=media&amp;token=0085b684-a2c2-4d5b-bbbe-d305124fc999" alt=""><figcaption></figcaption></figure>

{% code title="Staff notification snippet" %}

```liquid
<div class='bss-po-email'>
  {% for property in line.properties %}
    {%- unless property.first contains '__bss_po_' -%}
      {% assign bss_p_first = property.first | replace_first: '_', '' %}
      {{ bss_p_first }}: {{ property.last }}<br/>
    {% endunless %}
  {% endfor %}
</div>
```

{% endcode %}
{% endstep %}

{% step %}

#### Paste the Store-confirm-step3 snippet after the component display

Find `{{ component_display }}` in the HTML Body and paste the **Store-confirm-step3** snippet right after `<br>`.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FwR5c63nMGgeXR5Ebdphd%2Fimage.png?alt=media&amp;token=774ba6c1-751d-4faa-91ae-b6d9ba90ee6b" alt=""><figcaption></figcaption></figure>

{% code title="Store-confirm-step3" %}

```liquid
<div class='bss-po-email'>
  {% for property in component.properties %}
    {%- unless property.first contains '__bss_po_' -%}
      {% assign bss_p_first = property.first | replace_first: '_', '' %}
      {{ bss_p_first }}: {{ property.last }}<br/>
    {% endunless %}
  {% endfor %}
</div>
```

{% endcode %}
{% endstep %}

{% step %}

#### Paste the Store-confirm-step3 snippet after the component quantity

Find `{{ component.quantity }}` in the HTML Body and paste the **Store-confirm-step3** snippet again, right after `{% endif %}`.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FFmtKTeZCDA6FDwAN6TMX%2Fimage.png?alt=media&amp;token=2fe8304e-d49f-45a9-996b-47a283a5dfb5" alt=""><figcaption></figcaption></figure>

{% code title="Store-confirm-step3" %}

```liquid
<div class='bss-po-email'>
  {% for property in component.properties %}
    {%- unless property.first contains '__bss_po_' -%}
      {% assign bss_p_first = property.first | replace_first: '_', '' %}
      {{ bss_p_first }}: {{ property.last }}<br/>
    {% endunless %}
  {% endfor %}
</div>
```

{% endcode %}
{% endstep %}

{% step %}

#### Save

Save the template and wait 30 seconds. Done!

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FTJVZNBfbD8giaHUd1Lvr%2Fimage.png?alt=media&amp;token=95a67956-49a1-4416-b013-42673c0f8b15" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Ensure all items are fulfilled from the same location.** When using a Price add-on, all option items and the main product must come from the same location. Otherwise, the packing slip will not print the product's options.
{% endhint %}

## Related guides

* [Automation](https://docs.optis.me/product-options/order/automation) — automatically add order note & order tag instead of/in addition to email and packing slip
* [Manage add-on (additional fee for option)](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)
* [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features)


# Automation

## Overview

**Order note & Order tag automation** writes your customers' selected OPTIS options directly into the Shopify order — as an **Order note** and/or as **Order tags** — the moment an order is created. No manual copy-pasting, and no relying on staff to open each order and check the options.

* 📝 **Order note** — adds a note listing every selected option, one line item per section.
* 🏷️ **Order tag** — applies a fixed tag to every order with options, and/or custom tags based on which option/value was chosen (for example, tag rush orders, engraved items, or a specific color for picking/fulfillment).
* ⚡ Runs automatically on **new orders**, including unpaid ones (COD, pending payment) — you don't need to wait for the order to be paid.

{% hint style="info" %}
Order note & Order tag automation is available on the **Platinum** plan and above. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

## Where to find it

In the app's left menu, go to **Orders > Automation** tab. You'll see two sections: **Order note** and **Order tag**.

## Order note

{% stepper %}
{% step %}

#### **Turn on Show selected options in Order Note.**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Ff9ypn9HZxv3hWZZzI7yu%2Fimage.png?alt=media&amp;token=b851c37f-dd2a-464e-b540-8d60872b0c4d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **(Optional) Open Customize Note to edit the note's content using Liquid/HTML**

1. The default template lists each line item that has options, with one `- Option name: value` line per option:

```liquid
{%- assign has_previous_item = false -%}
{%- for line in line_items -%}
  {%- assign property_size = line.properties | size -%}
  {%- if property_size > 0 -%}
    {%- if has_previous_item -%}{{ "\n" }}{%- endif -%}
    {{ forloop.index }}. {{ line.title }}
    {%- for p in line.properties -%}
      {%- unless p.last == blank or p.first contains '_bss' -%}
        {%- assign bss_p_first = p.first | replace_first: '_', '' -%}
        {{ "\n" }}- {{ bss_p_first }}: {{ p.last }}
      {%- endunless -%}
    {%- endfor -%}
    {%- assign has_previous_item = true -%}
  {%- endif -%}
{%- endfor -%}
```

Click **View the Liquid variable list** for the variables you can use:

| Variable description | Liquid snippet                                    |
| -------------------- | ------------------------------------------------- |
| Line items           | `{% for line in line_items %} ... {% endfor %}`   |
| Name                 | `{{ line.name }}`                                 |
| Title                | `{{ line.title }}`                                |
| Variant title        | `{{ line.variant_title }}`                        |
| Properties           | `{% for p in line.properties %} ... {% endfor %}` |

Made a mess of the template? Click **Revert to default** to restore the original one. 3. Under **Writing behaviour**, choose how the app should treat a note that already exists on the order:

* **Keep existing order notes (Recommended)** checked — the app appends the options as a new line below whatever note is already there.
  {% endstep %}

{% step %}

#### **Click Save.**

{% endstep %}

{% step %}

#### Test Order Note

Click **Test** next to the Order note title, pick an order from your latest 50 orders that contain OPTIS options, and click **Start test**. The app writes the note to that real order right away so you can check the result in Shopify admin.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F93hcqObfQzh15WERqa8s%2Fimage.png?alt=media&amp;token=21dfed38-97d2-4c9b-9743-0b104b354fcb" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fiu6EsuYstr1OLyOdoTvC%2Fimage.png?alt=media&amp;token=5e215e48-198b-4344-874e-f248acaa9bc4" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Order tag

### Fixed tag

Turn on **Fixed tag** and enter a tag name (up to 40 characters) to apply that exact tag to **every** order that contains OPTIS options — useful for filtering "orders with custom options" in Shopify admin.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FnwORXFPZ7aBveQNn3fYo%2Fimage.png?alt=media&amp;token=3267a698-9ca2-4bea-9853-e73ae0ac741a" alt=""><figcaption></figcaption></figure>

### Custom tag rules

Custom tag rules let you tag orders based on which option/value the customer actually picked. Click **Add tag** and fill in:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FaxS5ffV2lhRrScSn7k0P%2Fimage.png?alt=media&amp;token=33021bd3-88e4-4b11-9443-f80ba224fce3" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="165.74609375">Field</th><th>What it does</th></tr></thead><tbody><tr><td>Tag rule</td><td>A name to help you identify the rule later (internal only, not the tag itself, max 28 characters).</td></tr><tr><td>Status</td><td>Enable/disable the rule without deleting it.</td></tr><tr><td>Option set</td><td>The option set to check.</td></tr><tr><td>Option</td><td>The specific option in that set to check.</td></tr><tr><td>Condition</td><td>How to compare the customer's selected value — see the table below.</td></tr><tr><td>Value</td><td>The value to compare against (or <strong>Any value</strong>, to match regardless of what was picked).</td></tr><tr><td>Tag name</td><td>The tag to apply when the rule matches. You can insert <code>{{option_set}}</code>, <code>{{option_name}}</code>, <code>{{option_value}}</code> — they're replaced with the real option set/option/selected value on the order. A live preview shows how the tag will look.</td></tr></tbody></table>

{% hint style="warning" %}
Shopify order tags are limited to **40 characters**. If a rule's tag (including the substituted variables) goes over that limit, it won't be added to the order — check the **Preview** in the rule form before saving.
{% endhint %}

Click the number in the **Tagged orders** column to see which of your latest 50 option orders matched that rule — click a row to open the order in Shopify admin.

### Test it

Click **Test** to apply your fixed tag and/or matching custom tag rules to a real order you pick from the latest 50 orders with OPTIS options.

## How it works

* The app watches for new orders that contain OPTIS options and writes the note/tags automatically, usually within seconds — no need to open the order yourself.
* It also covers unpaid orders (e.g. cash on delivery, pending payment), not just paid ones.
* Matching for custom tag rules is based on the option's **label** as it appears on the product page. If you rename an option's label after creating a rule for it, or if two different options share the same label, the rule may stop matching or match the wrong option — update the rule after renaming a label.


# Translate your option sets and default texts

If you sell in more than one language, you can translate what your customers see: the texts of your option sets (names, values, tooltips and error messages) and the built-in texts of OPTIS (labels, error messages and instructions). OPTIS shows the translation that matches the language your customer is browsing your store in.

{% hint style="info" %}
Translation and the **Translation Texts** settings are available on the **Advanced** plan and above. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

Go to **Settings > Translation Texts**. There are two parts:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FOc93pkatgYmpjobekNBK%2FScreenshot%20(52).png?alt=media&amp;token=d603dbea-1e69-499d-87f8-5cdfe9b28e5e" alt=""><figcaption></figcaption></figure>

* **Default text customization** - change the wording of the built-in texts in your main language.
* **Option set translation** and **Default text translation** - translate your option sets and the built-in texts into other languages with a spreadsheet.

## Change the built-in texts (Default text customization)

Use this to rename the built-in labels, error messages and instructions that OPTIS shows on your storefront. Choose the page, edit the text and click **Save**:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FKQ1HpfnHQyiHLr1p5b1E%2FScreenshot%20(54).png?alt=media&amp;token=ac289b66-c6b4-40df-b1b9-33d8b364e667" alt=""><figcaption></figcaption></figure>

**Product page**

* **Error message**: **Option {{Option name}} is required**, **Min character** / **Max character** / **Characters**, **Min value** / **Max value**, **Min selector** / **Max selector**, **Min quantity** / **Max quantity**, **File size**, **Number of files**, **Invalid time**, **Invalid date range**, **Email format is invalid** and **Phone number is invalid**.
* **Live preview**: the label of the live preview size field.
* **File upload**: the **Choose file** button text and the **Dropzone instruction** ("or drop file to upload").

**Cart page**

* **In-cart Editing**: **Edit options**, **Update** and **Cancel**.
* **Discount box**: **Apply**, **Enter your discount here**, **Discount field must not be blank**, **Invalid error** and **Discount**.

**Checkout page**

* **Price add-on**: **Selection extra fee for** {{Product title}}.

A preview next to the form shows how the text looks. Use **Reset** to go back to the default wording. Keep placeholders such as {{Option name}} and {{Product title}} in your text: OPTIS replaces them with the real name.

## Translate into other languages

Both **Default text translation** (built-in texts) and **Option set translation** (your option sets) work the same way with a translation file:

{% embed url="<https://youtu.be/m2CyX0eGOq8?si=0Twq7mAFEReesv4m>" %}

### Step 1: Sync data and download the translation template

Click **Download**. OPTIS syncs your data and gives you a template file (.xlsx or .csv) that contains all the texts to translate:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FyC3QVq6qKLIDpNXdpPNn%2FScreenshot%20(56).png?alt=media&amp;token=01a85cec-ffad-4afe-9e3b-af9d8fe435f7" alt=""><figcaption></figcaption></figure>

* For **Default text translation**: the built-in labels, error messages and storefront instructions.
* For **Option set translation**: the texts of your option sets (names, values, tooltips and error messages).

If there is nothing to export yet, the app shows **No data to export yet**. Create your option sets first and try again.

### Step 2: Edit the template

1. Open the template file.
2. The first row contains the language codes (for example en, fr, ja). The second row shows the language name of each code (for example English, French, Japanese).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fx80kaASCWKGjNwA68kQ1%2FScreenshot%20(58).png?alt=media&amp;token=691f67f4-a3a9-4ebd-9532-0d330211adec" alt=""><figcaption></figcaption></figure>

3. Find the column of the language you want to translate.
4. Type your translations in that column, matching each row with the original text in the **Default** column.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FMUCpcmjCWYwy8Cnx35yB%2FScreenshot%20(60).png?alt=media&amp;token=2b95e552-d2aa-4166-8e7f-2e42cdd8dac8" alt=""><figcaption></figcaption></figure>

5. Only edit the columns of the languages you want to translate.

{% hint style="warning" %}
Do not edit the first 3 rows and the first 2 columns of the default text template. In the option set template, do not edit the first 3 rows and the first 3 columns.
{% endhint %}

### Step 3: Upload the traslation file

1. Click **Upload your file** and choose your file. It must be a **.csv** or **.xlsx** file smaller than **20 MB**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLk9a2JK9LtEVnck8oFh2%2FScreenshot%20(61).png?alt=media&amp;token=0d569011-bb2b-4d09-ab0a-9d49c09cb8a2" alt=""><figcaption></figcaption></figure>

2. Click **Upload and continue**, then verify your translation file when the app asks you to. If the structure is not correct, you see **File structure is incorrect**: fix the file and upload it again.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQESmUtQWCe1JaWrZHwiW%2FScreenshot%20(62).png?alt=media&amp;token=afe16704-d549-4a75-bcd0-c1e85fc73b14" alt=""><figcaption></figcaption></figure>

2. Click **Apply translations**. When it is done, you see **This translation file is successfully applied to your store**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FfnJsfE0oXJuveUjiLM7k%2FScreenshot%20(63).png?alt=media&amp;token=de33de96-4aa0-4104-80f1-1856ea3b5c8e" alt=""><figcaption></figcaption></figure>

After the import, OPTIS shows a summary such as "Found 120 text keys with translations for 3 languages", and any new languages that will be enabled.

To replace the translations, click **Click to replace** and upload a new file. To remove everything, click **Clear translation data** and confirm. This cannot be undone.

{% hint style="success" %}
Each part has a short tutorial video: **How to translate OPTIS default text** and **How to translate OPTIS option sets**. If you need help, click **Contact support**.
{% endhint %}

## Related guides

* [Translate the “Choose File” of File Upload](https://docs.optis.me/product-options/customize-design/translate-the-choose-file-of-file-upload)
* [Settings overview](https://docs.optis.me/product-options/customize-design/settings-overview)


# Product Personalizer - Live Mockup Settings

{% hint style="info" %}
**Plan:** Live mockup (Product personalizer) is available on the **Platinum** plan and above. On the Free plan you can try it on one live product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

## What is Product Personalizer/Live Mockup? <a href="#id-1-what-is-it" id="id-1-what-is-it"></a>

Live Mockup allows shoppers to see their customizations applied to the product **in real time** before adding it to the cart. As customers select options (text, images, colors, buttons, swatches, etc.), the product preview updates instantly, showing exactly how the final product will look.

## What Live Mockup Can Do <a href="#id-1-what-live-preview-can-do" id="id-1-what-live-preview-can-do"></a>

Live Mockup works seamlessly with your product options and variants to:

* Instantly reflect option changes on the product image
* Display text inputs, uploads, or selections directly on the product
* Update visuals without page reloads
* Support multiple option types: [Text box](https://docs.optis.me/product-options/20-option-types/text-input/text-box), [File upload](https://docs.optis.me/product-options/20-option-types/others/file-upload), [Image & Color Swatch](https://docs.optis.me/product-options/20-option-types/swatch-and-button/swatch) (Note: **Text box’s live mockup** can be combined with [Color picker](https://docs.optis.me/product-options/20-option-types/others/color-picker), [Color Swatch](https://docs.optis.me/product-options/20-option-types/swatch-and-button/swatch), [Font picker](https://docs.optis.me/product-options/20-option-types/choice-list/font-picker) to preview text color and styling in real time).

Customers can interact with options and immediately see the result — no guessing, no surprises.

**👉 View demo:** [Personalize Phone Case](https://optis-product-options-variant.myshopify.com/products/custom-phone-case), [Custom Tote Bag](https://optis-product-options-variant.myshopify.com/products/custom-tote-bag?variant=51026051793174), [Custom Pet Necklace](https://optis-product-options-variant.myshopify.com/products/custom-pet-necklace?variant=51026045436182)

## When to Use Live Mockup <a href="#id-1-when-to-use-live-preview" id="id-1-when-to-use-live-preview"></a>

If customers need to *see it to trust it*, Live Mockup is the right solution 🤩.

| **Use cases**                             | **Typical examples**                                                                    | **Why Live Mockup matters**                                                        |
| ----------------------------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| **Personalized products**                 | Engraved names or messages.- Custom text on apparel, mugs, phone cases                  | Customers see exactly how their custom requests look on the product before buying. |
| **Visual option differences**             | Color or material selection- Pattern or style changes                                   | Instantly updates the product image, making comparisons easy and intuitive         |
| **Print-on-demand & custom designs**      | Uploading personal logos or images- Choosing print positions- Previewing artwork layout | Helps customers confirm design placement before checkout, reducing order errors    |
| **Paid add-ons & upgrades**               | Gift wrapping styles- Extra decorations or finishes- Paid engraving or personalization  | Visualizing upgrades makes added costs easier to justify                           |
| **Made-to-order or non-returnable items** | Personalized or custom-built products                                                   | Visual confirmation is critical when products can’t be resold or returned          |

**Result:** Shoppers feel confident in their choices, while merchants benefit from higher conversions, fewer errors, and reduced support requests.

## How To Set Up <a href="#id-1-how-to-set-up" id="id-1-how-to-set-up"></a>

### A. Explaining the setting panels <a href="#id-2-a-explaining-the-setting-panels" id="id-2-a-explaining-the-setting-panels"></a>

1. Live Mockup tab

For options that support Live Preview (Text box, File Upload, Swatch), you’ll see a **Live mockup** tab located at the top right.

* What it does: The **Live mockup** tab controls how the option appears in the live preview on your product page.
* How it works with Option Content tab: The Product personalizer uses values from Option Content, so we recommend setting those up first.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FIrntsWtlGbanhuM76DE2%2F1.png?alt=media&amp;token=fe484b21-a526-443d-afd7-19554234e6c6" alt=""><figcaption></figcaption></figure>

2. Preview panel: **Select background**

When Live Mockup is enabled, start by selecting the Background first.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Ff8mE9bQs3LOE72EuNMQO%2F2.png?alt=media&amp;token=c6da7764-f950-4971-b905-7891945732cd" alt=""><figcaption></figcaption></figure>

**Select background**

![](https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/image_bbmbw0.png)

**Preview**\
After choosing a background, decide where the preview should appear:

| **All product images (default)** | The preview appears on all product images. When customers switch between images, the preview remains visible on each image.                                                                                                    |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **First product image only**     | The preview appears only on the first product image. If customers switch to another image, the live preview will no longer be shown.                                                                                           |
| **Variant image only**           | The preview appears only on the selected variant’s image. When customers change variants, the background updates to the corresponding variant image, and the preview is shown on that image instead of the main product image. |
| **Last product image only**      | The preview appears only on the last image in the product’s media list.                                                                                                                                                        |
| **Specific product image**       | The preview appears only on a specific product image, based on its position in the product’s media list. Enter the image order number to select which image the preview should appear on.                                      |

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fhl1cYYIUbg04EpGEA0mg%2F3.png?alt=media&amp;token=8bcc4149-b8f4-479b-8794-bf6546f4f2dc" alt=""><figcaption></figcaption></figure>

In the **Select background** window you can set:

* **Background type** - **Main product image** (uses the images of your product) or **Custom background** (upload your own image in JPG, PNG or WEBP format).
* **Preview mode** - which product image shows the preview (see the table above). For **Specific product image**, enter the **Image index**.
* **Select product for preview** (Main product image) - the product whose image is used while you set up the preview.
* **When to show background** (Custom background) - **The first product image from start**, or **Overlay when image/text option is selected or added** (the custom background only appears after the customer fills the option).

Click **Apply** to save the background. Use **Change image** to change it later.

**Note:** The preview may look smaller during setup. Use **Zoom In** to check details. The final preview on your live store will display as expected.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/image_4f6glb.png)

### How to set up the Product Personalizer (Live Mockup) <a href="#id-2-how-to-set-up-the-product-personalizer-live-preview" id="id-2-how-to-set-up-the-product-personalizer-live-preview"></a>

1. Decide which options need Live Preview (whether it is Text box / Swatch / File upload)
2. Set up the option settings first
3. Tick **Enable live mockup** in the **Live mockup** tab (it shows customers what their customized product looks like in real time)
4. Select background & preview options
5. Configure the Live Preview → Save → Choose product/customer condition for the option set

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FaGejXbcLuWwEZldcPAZe%2F1.png?alt=media&amp;token=ec40deb0-c0ca-4c0e-ac9e-0a209c2b61f0" alt=""><figcaption></figcaption></figure>

**Configurations explanations:**

* **Position** (**X-axis**, **Y-axis**, **Rotation**): where the content sits on the product image. You can also drag and drop the preview anywhere on the product image.
* **Style** (Text box): **Font source**, **Color source**, **Font size**, **Curved text angle**, **Opacity**, **Max width** (tick **Enable max width**) and **Text alignment** (left, center or right). These are the default settings used in the preview and applied to the final product.
* **Allow customers to change**: choose what customers may adjust. For a Text box: **Text position** and **Text size**. For a File upload or Swatch: **Image position** and **Image size**. When customers can change the text size, choose how: **Resize text directly on preview**, **Adjust with size input field** or **Allow both ways**. Leave these unticked to lock the design.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FKkuSL5StWc7OAF3roz4d%2F2.png?alt=media&amp;token=8988ec99-64cb-4141-8a56-d48bada5db2e" alt=""><figcaption></figcaption></figure>

**Text box**

* **Preview text:** The text shown in the preview (placeholder: "your text"). If a **Default value** is set in the option's **Content** tab, it is used automatically. If not, enter a sample value here (for example: “Add text”). Changes here affect the preview only and do not sync back to the Content tab.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fj3gWxs8n58muH9LSHnuc%2F3.png?alt=media&amp;token=b93e7fed-a34e-4d1f-8c96-b42e81413ff8" alt=""><figcaption></figcaption></figure>

* **Color source** > **Link with Color swatch** (applicable for color swatches only): Use when you want customers to select predefined colors for the text. Set up the Swatch option before linking it.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fx2bi9PE6RG3X12TvRQb4%2F4.png?alt=media&amp;token=1d0233d0-aa09-4953-86f7-9303ae0ef8b6" alt=""><figcaption></figcaption></figure>

* **Color source** > **Link with Color picker**: Use when you want customers to select their preferred color for the text. Set up the Color picker option before linking it. Choose **Custom** to use one fixed color.
* **Font source** > **Link with Font picker**: Use when you want customers to select the font of the text with a [Font picker](https://docs.optis.me/product-options/20-option-types/choice-list/font-picker). Choose **Google fonts** to use one fixed Google font.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fixvm4qVunXWTQBnJG0FL%2F5.png?alt=media&amp;token=89c7ba61-81f1-4913-8066-878564609998" alt=""><figcaption></figcaption></figure>

**File upload & Swatch**

* **Preview shape**: Choose **Square**, **Polygon**, **Ellipse**, **Star** or **Heart**, or upload your own with **Upload custom shape** (**Custom shape**).
* **Preview image width / height**: the size of the preview image (click the lock to keep the aspect ratio) and **Preview image sizing** (**Cover**, **Contain** or **Fill**).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FXy8wENmSZvldR8tFdKWk%2FScreenshot.png?alt=media&amp;token=664de551-932d-4bbe-a364-8ca43897163d" alt=""><figcaption></figcaption></figure>

**Swatch**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FTIt4qdSWIQG58lYrFFRO%2F7.png?alt=media&amp;token=758cd5b0-ffc4-4792-9411-0c8f7dfdf760" alt=""><figcaption></figcaption></figure>

![](https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/image_1kfumh7.png)


# Basic conditional logic

## 🎯 Objective

Conditional Logic allows you to show or hide product options dynamically based on your customer’s selections. The goal is to create a clean, intuitive, and user-friendly product configuration experience ✨

Want to show or hide options based on the product variant the customer picks? See [Advanced conditional logic (Shopify variant)](https://docs.optis.me/product-options/advanced-setup/advanced-conditional-logic-shopify-variant).

## How Visibility works

Conditional logic is called **Visibility** in the editor. You will find it in the **Display** tab of every option, and in the **Display** tab of a [group](https://docs.optis.me/product-options/20-option-types/others/option-group).

1. Open the option (or group) you want to show or hide and go to the **Display** tab.
2. Under **Visibility**, click **Add condition**.
3. Choose **Show** or **Hide**, and whether **all** or **any** of the conditions must match. The sentence reads, for example: "Show this option when all of the following conditions match".
4. For each condition, choose:
   * **Option** - the option whose answer controls this one.
   * **Condition** - **is**, **is not**, **contains** or **does not contain**. When the controlling option is a Number field, use **is**, **is not**, **less than** or **greater than**.
   * **Value** - the value to compare with. For options with a list of values (Dropdown menu, Radio button, Checkbox, Button, Swatch and so on) pick a value, or **Any value** to match as soon as the customer selects something. For Text box, Text area, Number field and Email options you type the value.
5. Add more conditions with **Add condition**, then click **Save**.

{% hint style="warning" %}

* The option set needs at least two options, because an option cannot be controlled by itself.
* **File upload**, **Date & time**, **Color picker**, **Paragraph**, **Heading**, **Divider** and **Pop-up modal** options cannot be used as the option that controls others. They can still be shown or hidden by other options.
* Conditional logic is an **Advanced** feature. On the Free plan you can use it on one product with a Premium option set. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
  {% endhint %}

#### <mark style="color:$primary;">Example 1: Text vs. Image for Embroidery</mark>

Imagine selling a custom T-shirt where customers choose between adding Text or an Image for embroidery.

✅ If they choose Text, they’ll see a textbox to type in.

✅ If they choose Image, they’ll get a file upload option instead.

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_1tvcyfr.png" alt=""><figcaption></figcaption></figure>

#### Here’s how to set it up <a href="#id-3-heres-how-to-set-it-up" id="id-3-heres-how-to-set-it-up"></a>

1️⃣ Create a radio button with “Text” and “Image” options.

2️⃣ Add a textbox for text input.

3️⃣ Add a file upload for images.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FhAIqM2bTA623ZFSKFUIA%2FScreenshot%20at%20Aug%2007%2016-34-35.png?alt=media&amp;token=adcb2dae-cbbb-4693-a0a0-d16837b30302" alt=""><figcaption></figcaption></figure>

4️⃣ Navigate to the **Display** tab > **Add condition**:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FbxJBtwQlyulkZjDZe20d%2FScreenshot%20at%20Aug%2007%2016-35-30.png?alt=media&amp;token=e9fe632d-07b2-408f-8500-69e52eef9f66" alt=""><figcaption></figcaption></figure>

5️⃣ Set up Conditional Logic to show only the relevant option based on their selection:

* For the Textbox: **Show** this option when 'Customize T-shirt' **is** 'Add text':

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FF7V5YxXMqCFioGFQXgfv%2F2.png?alt=media&amp;token=061682ca-48f5-477a-9f32-f5332016be99" alt=""><figcaption></figcaption></figure>

* For the File Upload: **Show** this option when 'Customize T-shirt' **is** 'Add image':

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fpwe6Wtp0A9SsBjjZpMsn%2F3.png?alt=media&amp;token=37930cc4-0f43-4b41-8728-ea9c1b72bdc9" alt=""><figcaption></figcaption></figure>

Now, customers only see what they need—keeping things clean and intuitive!

#### <mark style="color:$primary;">Example 2: Number of People & Textboxes</mark>

Let’s say you offer a T-shirt where customers can add names based on how many people they select.

✅ If they pick 1 person, they get 1 textbox.

✅ If they pick 2 people, they get 2 textboxes.

✅ If they pick 3 people, they get 3 textboxes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fcy3YMYRdOunhLOUY7Yfn%2FScreenshot%20at%20Aug%2007%2016-59-33.png?alt=media&amp;token=bd4a6f0f-674b-4505-ac77-426076aa8b0b" alt=""><figcaption></figcaption></figure>

#### Here’s how to set it up <a href="#id-3-heres-how-to-set-it-up" id="id-3-heres-how-to-set-it-up"></a>

1️⃣ Create an option with “1 person”, “2 people" and "3 people"

2️⃣ Add 3 textboxes for name input.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F7b4AFYFr72f9ZjbGk2tL%2F4.png?alt=media&amp;token=fb7b247e-92e0-4d38-ac96-379271111555" alt=""><figcaption></figcaption></figure>

3️⃣ Use Conditional Logic to:

* Show Textbox 1 for all 3 choices - because this Textbox 1 will appear on “1 person”, “2 people" and "3 people" selections.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FD1sOWPtvYHEk3x2dQLbk%2F5.png?alt=media&amp;token=28d9bb91-6bd7-457c-ae24-95fa63076568" alt=""><figcaption></figcaption></figure>

* Show Textbox 2 when "2 people" and "3 people" are selected - Because the second textbox will only appear for these 2 selections:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fifjmir4qSJWfrzZBCW7g%2F6.png?alt=media&amp;token=14e4c71c-2377-49d1-9789-81520c34f649" alt=""><figcaption></figcaption></figure>

* Lastly, show Textbox 3 when "3 people" is selected:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FeGv5RcB77nJoTwPAU6O9%2F7.png?alt=media&amp;token=7fe4447e-7d9d-4c01-bfdc-ea35f2a063fc" alt=""><figcaption></figcaption></figure>

Now, the form updates dynamically, keeping it simple and user-friendly!

And that’s it! Conditional Logic ensures customers only see what’s relevant - making their shopping experience smoother. Try it out and let us know how it works for you!


# Advanced conditional logic (Shopify variant)

## 🎯 Objective

Show or hide an option (or group) based on the **Shopify variant** your customer has selected on the product page. For example, show an "Engraving" text box only when the customer picks the variant **White / Large**.

New to conditional logic? Start with [Basic conditional logic](https://docs.optis.me/product-options/advanced-setup/how-to-set-up-conditional-logics), which shows or hides options based on other options in the option set.

{% hint style="info" %}
Shopify variant conditions work on [**Storefront V2**](https://docs.optis.me/product-options/optis-storefront-v2/how-to-upgrade-to-storefront-v2) only. If your store still uses the Legacy storefront, you will not see **Shopify variant** in the **Source** list.
{% endhint %}

## How to set it up

1. Open the option (or group) and go to the **Display** tab.
2. Under **Visibility**, click **Add condition**. New conditions start with **Shopify variant** as the source.
3. Choose **Show** or **Hide**, and whether **all** or **any** of the conditions must match.
4. Choose a **Condition** and a **Value** (see the table below).
5. Click **Save**.

Unlike basic conditional logic, an option set with only one option can already use Shopify variant conditions.

You can mix sources in the same block. For example, one condition can use **Shopify variant** and another can use an **Option**, combined with **all** or **any**.

## Conditions and values

| Condition                           | Value                                                                                                     |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **is** / **is not**                 | Click **Select product variant**, then pick the variant in the popup.                                     |
| **contains** / **does not contain** | Type text. OPTIS looks for it inside the variant name. Spaces and uppercase/lowercase must match exactly. |

### Pick a variant (is / is not)

1. Click **Select product variant**.
2. Search by product name or variant name, then select one variant.
3. Confirm. The condition now shows `Product name / Variant name`.

* You can pick a variant of **any product in your store**, not only the product this option set applies to.
* Products with only the **Default Title** variant are not listed, because they have no real variants to choose from.
* The condition is saved by variant, not by name. If you rename the product, option or value in Shopify, **is** / **is not** conditions keep working.

### Contains / does not contain

Shopify joins the values of a multi-option variant with " / ", for example **White / Large**. Type the text the same way, for example `White / Large`, or just `Large` to match every Large variant. Because the match is exact, use **is** / **is not** when you need to target one specific variant.

## Good to know

* **Deleted variant or product:** if the variant you selected is deleted in Shopify, the condition shows **Variant not found** in red. Pick another variant or remove the condition.
* **Preview in the editor:** the preview has no customer-selected variant, so Shopify variant conditions are ignored there and the option stays visible. Check them on your storefront. Conditions based on other options still show or hide the option in the preview.
* **Duplicate a condition:** the copy keeps the same product and variant.
* **Rolling back to the Legacy storefront:** Legacy does not support Shopify variant conditions. The rollback popup shows how many option sets use them, and those conditions are ignored on your storefront until you upgrade to Storefront V2 again.
* **Import / Export:** Shopify variant conditions are included in the CSV file. See [Export and Import Option Sets](https://docs.optis.me/pages/WnDdmTGHHjchuBgpVwvU#id-7.2-visibility-conditional_logic).


# Manage add-on (additional fee for option)

## Overview

A **price add-on** lets you charge an extra fee when customers choose a specific option or value, for example gift wrapping (+$5) or a premium material.

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_tdjsey.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Price add-on is available on the **Advanced** plan and above. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

## Add-on types

For each option (or each value of an option) you choose one of two add-on types:

| Type               | What it does                                                                                                                                                                                                                                                          | Plan               |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| **Extra fee**      | Charges the amount you enter on top of the product price.                                                                                                                                                                                                             | Advanced and above |
| **Upsell product** | Links the value to a Shopify variant, so the price and the stock of that variant are used. See [How to Use "Upsell product"](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value). | Platinum and above |

This guide explains how to set up an **Extra fee**.

## Which options can have an add-on

Where you set the add-on depends on the option type:

| Option types                                                                            | Where to set the add-on                                                |
| --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Text box, Text area, Number field, Email, Phone, File upload, Color picker, Font picker | **Option settings** > **Add-on** (one price for the whole option)      |
| Checkbox, Dropdown menu, Dropdown with thumbnail, Radio button, Switch, Button, Swatch  | **Option values** table > **Add-on** column (one price for each value) |
| Date & time, Paragraph, Heading, Divider, Pop-up modal                                  | Add-ons are not available                                              |

## Set up an extra fee

### Step 1: Open the option

In the option set editor, go to **1. Add options** and click the option you want to add a fee to. Its settings open in the **Content** tab.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F4RsbpLjH2zoSZ95u5uRd%2F1.png?alt=media&amp;token=ed1032f7-c3c5-4fde-842f-91b35b11408d" alt=""><figcaption></figcaption></figure>

### Step 2: Choose Extra fee and enter the price

Set **Add-on** to **Extra fee**, then enter the price:

* **Options with a list of values** - in the **Option values** table, choose **Extra fee** and type a price for each value in the **Add-on** column.
* **Single-value options** - in **Option settings**, choose **Extra fee** next to **Add-on** and type the price.

{% hint style="info" %}
Can't see the **Add-on** column? Click the **Columns** icon next to **Option values** and turn on **Add-on**.
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FfMOEk1L1JCTUVfpiT438%2F2.png?alt=media&amp;token=f764775e-dea4-4915-a5df-0b4d26786058" alt=""><figcaption></figcaption></figure>

### Step 3: Save and check on your store

1. Click **Save**.
2. Open the product page on your store and select the option. The extra fee is added to the price.

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_wm6l8c.png" alt=""><figcaption></figcaption></figure>

## How customers see the extra fee

* **On the product page** - you choose when the price appears in **Settings > General Settings > Option type setting > Add-on display**:
  * **After selecting option values** (default): the extra fee is shown once the customer selects the value.
  * **Next to option values**: the extra fee is always shown next to each value.
* **In the cart** - the extra fee is shown next to the selected value, for example (+$5).
* **At checkout** - the extra fee appears with the text **Selection extra fee for {{Product title}}**. You can rename this text in **Settings > Translation Texts > Default text customization > Checkout page**.
* **With Quantity** - if the option uses [Quantity](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options), the fee is multiplied by the quantity the customer chooses (for example, 3 x $5 = $15).

## Show the updated total price on the product page (optional)

To show the new total price on the product page while customers choose add-ons, install the advanced feature **Show updated total price with add-ons**. In the app, go to **Advanced features**, find the card and click **Self-install (for dev)**, or click **Contact us** and we install it for you for free. See [Show updated total price with add-ons](https://docs.optis.me/product-options/advanced-features/show-updated-total-price-with-add-ons).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FoeY65QsvarIPJNXWNtiY%2FScreenshot%20at%20Aug%2008%2009-42-46.png?alt=media&amp;token=17b2c3fd-6817-45a3-88a3-a32d63aa3e9c" alt=""><figcaption></figcaption></figure>

## Related guides

* [How to Use "Upsell product"](https://docs.optis.me/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value)
* [How to Use the "Quantity" Feature for Options](https://docs.optis.me/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options)
* [Show updated total price with add-ons](https://docs.optis.me/product-options/advanced-features/show-updated-total-price-with-add-ons)
* [Sync price list with market prices](https://docs.optis.me/product-options/advanced-features/sync-price-list-with-market-prices) - if you sell in several Shopify Markets
* [Settings overview](https://docs.optis.me/product-options/customize-design/settings-overview)
* [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features)


# How to Use the "Quantity" Feature for Options

### How to Use the "Quantity" Feature in OPTIS <a href="#id-3-how-to-use-the-quantity-feature-in-optis" id="id-3-how-to-use-the-quantity-feature-in-optis"></a>

The Quantity feature in OPTIS allows customers to select multiple option values in 1 option.

{% hint style="info" %}
Option quantity is available on the **Platinum** plan and above. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_d1swz5.png" alt=""><figcaption></figcaption></figure>

### How It Works <a href="#id-3-how-it-works" id="id-3-how-it-works"></a>

* **Enabling Quantity**: In the **Option values** table, use **Columns** to show the **Quantity** column, then check the box for each value where customers can adjust the quantity.
* **Min/Max Quantity:** Set a minimum and maximum limit to control how many times the total option number can be selected.
* **How It Affects Price Add-Ons:** The final price of a product will increase based on the selected quantity multiplied by the Price Add-On value.

### Example – Selecting Candies for Candy Box <a href="#id-3-example-selecting-candies-for-candy-box" id="id-3-example-selecting-candies-for-candy-box"></a>

#### **Setup in OPTIS:**

* **Option Name:** Select candies (up to 5)
* **Option Values:** 6 candy options
* **Min quantity** is 3, and **max quantity** is 5

This means customers can select up to 5 numbers of candies. For example, 4 black candies and 1 pink candy.

If you add add-on price for those candies, for example, black candy costs $5 and pink candy costs $10. Here is the total price if customers select 4 black candy + 1 pink candy:

* Total price = $5x4 (black) + $10x1 (pink) = $30

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fj5ehK6VaZmn6965udObt%2FScreenshot%20(20).png?alt=media&amp;token=5a38aac8-36bb-47d6-9a9d-33d658a1c8e2" alt=""><figcaption></figcaption></figure>

### Step by Step Guideline <a href="#id-1-step-by-step-guideline" id="id-1-step-by-step-guideline"></a>

1. In the **Option values** table, click **Columns** and turn on **Quantity** if the column is not visible, then check the **Quantity** box for the value.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQb1WwVmuotjGUqcOvIW6%2FScreenshot%20(14).png?alt=media&amp;token=8bff03ae-0839-4336-b4b2-f10f1c391a52" alt=""><figcaption></figcaption></figure>

2. Scroll down to the **Quantity** section. To avoid confusion, you can configure how customers select quantities based on two distinct types:

* **Limit how many different option values can be selected:** This limits how many *different choices* can be selected (e.g., "Pick from 1 to 3 candy types").

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FNNgOKOi1aNH1jJwRWTAm%2FScreenshot%20(7).png?alt=media&amp;token=ce8a8d3c-cfcf-4830-ab85-64f5cb5a5ee7" alt=""><figcaption></figcaption></figure>

* **Limit total quantity across all options:** This limits the sum of quantities across all chosen options in total combination (e.g., "Min quantity is 3, and max quantity is 5" across the selected candy types).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FINwA5mkXvRqUzPgZqtfb%2FScreenshot%20(8).png?alt=media&amp;token=26d7eb51-7288-4fb4-91cf-d88efe5058f5" alt=""><figcaption></figcaption></figure>

3. On the section "**Add-on**", enter an extra charge per unit (if needed)

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FcPXPrwveWnOYwv97iF3M%2FScreenshot%20(16).png?alt=media&amp;token=a7a0149c-7a37-4b9b-9e4a-ce190345cff9" alt=""><figcaption></figcaption></figure>

4. Click **Save** to apply the changes.


# Export and Import Option Sets

This guide explains how to use the **Import/Export** page (Option sets → Import/Export) to bulk-export your option sets to a CSV file, edit them offline, and re-import them — including exactly what to put in every column.

It's written directly from the app's own validation code, so the rules, limits, and error messages below match what you'll actually see in the product.

{% hint style="info" %}
Import / Export is available on the **Advanced** plan and above. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

***

### 1. Overview

The Import/Export page has two independent tools:

<table><thead><tr><th width="106.23828125">Tool</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Export</strong></td><td>Downloads your option sets (all of them, or a hand-picked subset) as one CSV file.</td></tr><tr><td><strong>Import</strong></td><td>Uploads a CSV file, checks it, shows you a review screen, and creates/updates option sets from it.</td></tr></tbody></table>

The most reliable way to build an import file is to **export first, then edit the CSV**, rather than writing one from scratch. That way the header row, column order, and the exact JSON shape of the advanced fields are guaranteed correct.

***

### 2. Exporting option sets

{% stepper %}
{% step %}
Click **Export** on the Export Option sets card.
{% endstep %}

{% step %}
Choose a scope:

* **All option sets** — everything in the store.
* **Selected option sets** — check the ones you want, click **Select**, then **Export option sets**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FOdP72V92QhhAU5BfeSok%2Fimage.png?alt=media&amp;token=dc1d04e3-95fa-442f-bfe7-3de442e4ace7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
The file downloads as a single `.csv`.
{% endstep %}
{% endstepper %}

***

### 3. Importing option sets — step by step

{% stepper %}
{% step %}

#### Prepare your file

Download the sample template or start from a file you just exported. Edit it in Excel/Google Sheets/a text editor, keeping the header row untouched.

**Hard limits, checked immediately on upload, before anything else happens:**

<table><thead><tr><th width="177.69140625">Limit</th><th width="556.30859375">Value</th></tr></thead><tbody><tr><td>File type</td><td><code>.csv</code> only</td></tr><tr><td>Max file size</td><td>20 MB</td></tr><tr><td>Max data rows</td><td>50,000</td></tr><tr><td>Header row</td><td>Must exactly match the 45 expected column names, in order</td></tr><tr><td>Content</td><td>The file can't be effectively empty</td></tr></tbody></table>

Any of these fail instantly with an **"Import failed"** error — no job is created, nothing is stored.
{% endstep %}

{% step %}

#### Upload and Import

Click **Import** → **Add file** (or drag-and-drop) → **Upload and Import**. Only one import can run per store at a time; starting a new one while another is mid-review replaces it.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FyzD8SenyuayavDufw57R%2Fimage.png?alt=media&amp;token=474eab29-69b9-44c8-9184-12239d491670" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Validating and Review

If errors were found, it will show one of these messages:

* 🔴 "**N validation errors found"** — hard errors: a required field is missing, or a field's value/format is wrong. This blocks the import entirely — nothing can be imported until the file is fixed and re-uploaded.
* 🟡 "**N references not found in your store"** — warnings: a field's format is fine, but it points at something that isn't a real product/customer/tag/variant on your store. This does not block the import — click **Continue import** and the file imports normally, with that specific setting removed / falling back to its default.
  * Click **Continue import** to actually write the option sets to your store
    {% endstep %}

{% step %}

#### Complete the import

🟢 **"Import completed successfully"** banner shows how many option sets were imported.
{% endstep %}
{% endstepper %}

#### 💡Bonus: looking up variant IDs

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FOOzBVteHjP08zTvYBoew%2Fimage.png?alt=media&amp;token=6db56d3a-26f6-48aa-8797-e1c436653142" alt=""><figcaption></figcaption></figure>

The search box under the Import button (**Search variant ID**) opens a product/variant search-and-copy tool — use it to find the exact Shopify variant IDs to paste into `Products` (`product variant: ...`) or `Upsell_product_ID`.

***

### 4. How rows fit together (the data model)

Every CSV row is one of four types:

<table><thead><tr><th width="195.703125">Row type</th><th>Fills in</th></tr></thead><tbody><tr><td><strong>Set's first row</strong></td><td><code>Option_set_id</code>, <code>Option_set_name</code>, <code>Priority</code>, <code>Status</code>, <code>Products</code>, <code>Exclude_products</code>, <code>Customers</code> — plus its own option data</td></tr><tr><td><strong>Later row, same set</strong></td><td><code>Option_set_id</code> only (same value); the rest stay <strong>blank</strong> (= "same as first row")</td></tr><tr><td><strong>Option Group row</strong></td><td><code>Option_type</code> = <code>Option Group</code>; groups other options via <code>Option_in_group</code> (one name per line) — doesn't collect input itself</td></tr><tr><td><strong>Value row</strong></td><td>One row per choice, for choice-list types (Checkbox, Dropdown, Radio Button, Swatch, Button, Switch, Dropdown w/ Thumbnail); <code>Option_id</code> repeats, <code>Option_type</code>/<code>Option_name</code> stay blank</td></tr></tbody></table>

***

### 5. Full field reference

This section cross-checks the app's actual validation code against the **`Field`** sheet in the Excel file you sent. Every column gets: whether it's required, which row(s) need it, and **exactly what to type**. Where the Excel doc and the current code disagree, that's called out explicitly rather than silently picking one.

> A cell you leave blank on a required-on-first-row field is a hard error *only* on that first row — the same blank cell on a continuation/value row is completely normal.

<table><thead><tr><th width="50.44140625">#</th><th width="152.16796875">Field</th><th>Required?</th><th>Scope</th><th>Allowed values</th><th>Example</th></tr></thead><tbody><tr><td>1</td><td><code>Option_set_id</code></td><td><strong>Required</strong>, every row</td><td>Every row of the set</td><td>Number</td><td><code>1</code></td></tr><tr><td>2</td><td><code>Option_set_name</code></td><td><strong>Required</strong> (1st row)</td><td>Set, first row only</td><td>Free text</td><td><code>Custom T-shirt</code></td></tr><tr><td>3</td><td><code>Priority</code></td><td>Optional</td><td>Set, first row only</td><td><code>0</code>–<code>99</code>; blank = <code>0</code></td><td><code>0</code></td></tr><tr><td>4</td><td><code>Status</code></td><td>Optional (1st row)</td><td>Set, first row only</td><td><code>Live</code> / <code>Inactive</code></td><td><code>Live</code></td></tr><tr><td>5</td><td><code>Products</code></td><td>Optional</td><td>Set, first row only</td><td>See <a href="#id-7.1-products-exclude_products-customers">§7.1</a></td><td><code>collections: New arrivals</code></td></tr><tr><td>6</td><td><code>Exclude_products</code></td><td>Optional</td><td>Set, first row only</td><td>See <a href="#id-7.1-products-exclude_products-customers">§7.1</a></td><td><code>tags: discontinued</code></td></tr><tr><td>7</td><td><code>Customers</code></td><td>Optional</td><td>Set, first row only</td><td>See <a href="#id-7.1-products-exclude_products-customers">§7.1</a></td><td><code>registered</code></td></tr><tr><td>8</td><td><code>Option_id</code></td><td><strong>Required</strong>, every row</td><td>Every row of the option</td><td>Number</td><td><code>5</code></td></tr><tr><td>9</td><td><code>Option_type</code></td><td><strong>Required</strong> (1st row)</td><td>Option, first row only</td><td>See <a href="#id-6.-option-types-reference">§6</a></td><td><code>Swatch</code></td></tr><tr><td>10</td><td><code>Option_name (Label_product)</code></td><td><strong>Required</strong> (1st row)</td><td>Option, first row only</td><td>Free text</td><td><code>Choose Your Color</code></td></tr><tr><td>11</td><td><code>Label_cart</code></td><td>Optional</td><td>Option, first row only</td><td>Free text</td><td><code>Color</code></td></tr><tr><td>12</td><td><code>Hide_label</code></td><td>Optional</td><td>Option, first row only</td><td><code>Yes</code> / <code>No</code></td><td><code>No</code></td></tr><tr><td>13</td><td><code>Required</code></td><td>Optional</td><td>Option, first row only</td><td><code>Yes</code> / <code>No</code></td><td><code>Yes</code></td></tr><tr><td>14</td><td><code>Hide_option</code></td><td>Optional</td><td>Option's 1st row / Group row</td><td><code>Yes</code> / <code>No</code></td><td><code>No</code></td></tr><tr><td>15</td><td><code>Column_width</code></td><td>Recommended</td><td>Option, first row only</td><td><code>100</code>/<code>75</code>/<code>66</code>/<code>50</code>/<code>33</code>/<code>25</code></td><td><code>33</code></td></tr><tr><td>16</td><td><code>Option_value</code></td><td>Required for choice lists</td><td>Every value row</td><td>Free text</td><td><code>Red</code></td></tr><tr><td>17</td><td><code>Helptext_option_value</code></td><td>Optional</td><td>Every value row</td><td>Free text</td><td><code>Good choice</code></td></tr><tr><td>18</td><td><code>SKU_value</code></td><td>Optional</td><td>Every value row</td><td>Free text</td><td><code>ABC</code></td></tr><tr><td>19</td><td><code>Swatch_value</code></td><td>Required for Swatch etc.</td><td>Every value row</td><td>Hex or image CDN URL</td><td><code>#ffffff</code></td></tr><tr><td>20</td><td><code>Swatch_title_display_type</code></td><td>Optional, Swatch only</td><td>Option's first value row</td><td>See §5.3</td><td><code>None</code></td></tr><tr><td>21</td><td><code>Option_price_type</code></td><td>Optional</td><td>Value rows</td><td><code>Extra fee</code> / <code>Upsell product</code></td><td><code>Extra fee</code></td></tr><tr><td>22</td><td><code>Option_price</code></td><td>Optional</td><td>Value rows</td><td>Number</td><td><code>100</code></td></tr><tr><td>23</td><td><code>Upsell_product_ID</code></td><td>Optional</td><td>Value rows</td><td>Product/variant ID</td><td><code>['123456789']</code></td></tr><tr><td>24</td><td><code>Group_display_type</code></td><td>Optional</td><td>Option Group row</td><td><code>Expand</code> / <code>Collapse</code></td><td><code>Expand</code></td></tr><tr><td>25</td><td><code>Option_in_group</code></td><td>Optional</td><td>Option Group row</td><td>Names, one per line</td><td><code>Color</code></td></tr><tr><td>26</td><td><code>Visibility (Conditional_logic)</code></td><td>Optional</td><td>Option, first row only</td><td>JSON — <a href="#id-7.2-visibility-conditional_logic">§7.2</a></td><td>see §7.2</td></tr><tr><td>27</td><td><code>Min_selections_characters</code></td><td>Optional</td><td>Option, first row only</td><td>Number</td><td><code>1</code></td></tr><tr><td>28</td><td><code>Max_selections_characters</code></td><td>Optional</td><td>Option, first row only</td><td>Number > Min</td><td><code>2</code></td></tr><tr><td>29</td><td><code>Enable_quantity</code></td><td>Optional</td><td>Option, first row only</td><td><code>Yes</code> / <code>No</code></td><td><code>Yes</code></td></tr><tr><td>30</td><td><code>Min_quantity</code></td><td>Optional</td><td>Option, first row only</td><td>Number</td><td><code>1</code></td></tr><tr><td>31</td><td><code>Max_quantity</code></td><td>Optional</td><td>Option, first row only</td><td>Number > Min</td><td><code>10</code></td></tr><tr><td>32</td><td><code>Dropdown_search_bar</code></td><td>Optional</td><td>Option, first row only</td><td><code>Yes</code> / <code>No</code></td><td><code>No</code></td></tr><tr><td>33</td><td><code>Placeholder_text</code></td><td>Optional</td><td>Option, first row only</td><td>Free text</td><td><code>Enter text here</code></td></tr><tr><td>34</td><td><code>Default_value</code></td><td>Optional</td><td>Option, first row only</td><td>Text, or <code>Yes</code> per pre-selected value</td><td>—</td></tr><tr><td>35</td><td><code>Helptext_content</code></td><td>Optional</td><td>Option, first row only</td><td>Free text</td><td><code>Easy to setup</code></td></tr><tr><td>36</td><td><code>Helptext_position</code></td><td>Optional</td><td>Option, first row only</td><td>See §5.3</td><td><code>Tooltip</code></td></tr><tr><td>37</td><td><code>Option_value_orientation</code></td><td>Optional</td><td>Option, first row only</td><td><code>Horizontal</code> / <code>Vertical</code></td><td><code>Horizontal</code></td></tr><tr><td>38</td><td><code>Rich_text_value</code></td><td>Required for static text</td><td>Option, first row only</td><td>HTML</td><td><code>&#x3C;p>...&#x3C;/p></code></td></tr><tr><td>39</td><td><code>Label_on_popup</code></td><td>Optional, Popup only</td><td>Option, first row only</td><td>Free text</td><td><code>Read more</code></td></tr><tr><td>40</td><td><code>Phone_settings</code></td><td>Required for Phone</td><td>Option, first row only</td><td>JSON — <a href="#id-7.7-phone_settings">§7.7</a></td><td>see <a href="#id-7.7-phone_settings">§7.7</a></td></tr><tr><td>41</td><td><code>Font_picker_settings</code></td><td>Required for Font Picker</td><td>Option, first row only</td><td>JSON — <a href="#id-7.3-font_picker_settings">§7.3</a></td><td>see <a href="#id-7.3-font_picker_settings">§7.3</a></td></tr><tr><td>42</td><td><code>File_upload_settings</code></td><td>Required for File Upload</td><td>Option, first row only</td><td>JSON — <a href="#id-7.4-file_upload_settings">§7.4</a></td><td>see <a href="#id-7.4-file_upload_settings">§7.4</a></td></tr><tr><td>43</td><td><code>Date_time_settings</code></td><td>Required for Date &#x26; Time</td><td>Option, first row only</td><td>JSON — <a href="#id-7.5-date_time_settings">§7.5</a></td><td>see <a href="#id-7.5-date_time_settings">§7.5</a></td></tr><tr><td>44</td><td><code>Live_mockup</code></td><td>Optional, advanced</td><td>Option, first row only</td><td>JSON — <a href="#id-7.6-live_mockup-background">§7.6</a></td><td>see <a href="#id-7.6-live_mockup-background">§7.6</a></td></tr><tr><td>45</td><td><code>Background</code></td><td>Optional, advanced</td><td>Option, first row only</td><td>JSON — <a href="#id-7.6-live_mockup-background">§7.6</a></td><td>see <a href="#id-7.6-live_mockup-background">§7.6</a></td></tr></tbody></table>

***

### 6. Option types reference

<table><thead><tr><th width="194.23046875">Option type</th><th width="155.6015625">Has a value list?</th><th>Notes</th></tr></thead><tbody><tr><td><code>Text Box</code></td><td>No</td><td>Single row. Uses <code>Placeholder_text</code>, <code>Default_value</code>, <code>Min/Max_selections_characters</code>.</td></tr><tr><td><code>Number Field</code></td><td>No</td><td>Single row. Uses <code>Placeholder_text</code>, <code>Default_value</code>, <code>Min/Max_selections_characters</code>.</td></tr><tr><td><code>Email</code></td><td>No</td><td>Single row. Uses <code>Placeholder_text</code>, <code>Default_value</code>, <code>Min/Max_selections_characters</code>.</td></tr><tr><td><code>Phone</code></td><td>No</td><td>Single row. Requires <code>Phone_settings</code>; <code>Default_value</code> is digits only.</td></tr><tr><td><code>Text Area</code></td><td>No</td><td>Single row. Uses Single row. Uses <code>Placeholder_text</code>, <code>Default_value</code>, <code>Min/Max_selections_characters</code>.</td></tr><tr><td><code>Checkbox</code></td><td>Yes</td><td>One row per checkbox choice.</td></tr><tr><td><code>Dropdown Menu</code></td><td>Yes</td><td>One row per menu item.</td></tr><tr><td><code>Dropdown Menu With Thumbnail</code></td><td>Yes</td><td>One row per item; <code>Swatch_value</code> holds the thumbnail image URL.</td></tr><tr><td><code>Radio Button</code></td><td>Yes</td><td>One row per choice.</td></tr><tr><td><code>Swatch</code></td><td>Yes</td><td>One row per swatch; <code>Swatch_value</code> is a hex color or image; <code>Swatch_title_display_type</code> controls label placement.</td></tr><tr><td><code>Button</code></td><td>Yes</td><td>One row per button choice.</td></tr><tr><td><code>Switch</code></td><td>Yes</td><td>One row per switch choice.</td></tr><tr><td><code>File Upload</code></td><td>No</td><td>Single row. Requires <code>File_upload_settings</code>.</td></tr><tr><td><code>Date &#x26; Time</code></td><td>No</td><td>Single row. Requires <code>Date_time_settings</code>.</td></tr><tr><td><code>Color Picker</code></td><td>No</td><td>Single row — lets the customer pick any custom color.</td></tr><tr><td><code>Font Picker</code></td><td>No</td><td>Single row. Requires <code>Font_picker_settings</code>; can apply to other text options via that JSON's <code>listOptionApplied</code>.</td></tr><tr><td><code>Paragraph</code></td><td>No</td><td>Single row. Content goes in <code>Rich_text_value</code>.</td></tr><tr><td><code>Heading</code></td><td>No</td><td>Single row. Content goes in <code>Rich_text_value</code>.</td></tr><tr><td><code>Divider</code></td><td>No</td><td>Single row. Purely visual; html goes in <code>Rich_text_value</code></td></tr><tr><td><code>Pop-up Modal</code></td><td>No</td><td>Single row. Content in <code>Rich_text_value</code>, trigger label in <code>Label_on_popup</code>.</td></tr><tr><td><code>Option Group</code></td><td>—</td><td>Bundles other options together. Uses <code>Group_display_type</code> + <code>Option_in_group</code>.</td></tr></tbody></table>

***

### 7. Special field formats

#### 7.1 `Products` / `Exclude_products` / `Customers`

These three columns use short text prefixes to say *which kind* of condition you mean. Everything after the prefix is separated with `;` (semicolons) — except a plain product-title list, which can use newlines or commas.

**`Products`** (who this option set applies to)

<table><thead><tr><th width="272.83984375">Meaning</th><th>What to type</th></tr></thead><tbody><tr><td>All products</td><td>leave blank, or <code>all</code></td></tr><tr><td>Specific products</td><td>just the product title(s), one per line: <code>Custom T-shirt</code>⏎<code>Custom Phone Case</code></td></tr><tr><td>Specific collections</td><td><code>collections: Collection A; Collection B</code></td></tr><tr><td>Products with a tag</td><td><code>tags: freeship; sale</code></td></tr><tr><td>Specific product variants (by ID)</td><td><code>product variant: 41816231542953; 44240103014715</code></td></tr></tbody></table>

**`Customers`** (who sees this option set)

<table><thead><tr><th width="279.64453125">Meaning</th><th>What to type</th></tr></thead><tbody><tr><td>All customers</td><td>leave blank, or <code>all</code></td></tr><tr><td>Registered / logged-in customers</td><td><code>registered</code></td></tr><tr><td>Guests (no account)</td><td><code>without accounts</code></td></tr><tr><td>Specific customers, by email</td><td><code>specific: a@gmail.com; b@gmail.com</code></td></tr><tr><td>Customers with a tag</td><td><code>tags: vip; wholesale</code></td></tr></tbody></table>

**`Exclude_products`** (removes products from the match above)

<table><thead><tr><th width="284.3671875">Meaning</th><th>What to type</th></tr></thead><tbody><tr><td>None</td><td>leave blank, or <code>None</code></td></tr><tr><td>By products tag</td><td><code>tags: discontinued; clearance</code></td></tr></tbody></table>

> Currently `Exclude_products` only recognizes the `tags:` format (or blank/`None`). Typing a plain product title here has no effect — if you need to exclude specific products by name, use a product tag instead.

A reference that doesn't match anything on your store (a typo'd collection name, an email that isn't a customer) shows up as a **warning**, not a hard error — the field is simply cleared if you continue.

#### 7.2 `Visibility (Conditional_logic)`

Shows or hides this option depending on the value of *another option in the same set*.

```json
{
  "action": "show",
  "match": "all",
  "conditions": [
    { "option_label": "Color", "operator": "IS", "value": "Red" },
    { "option_label": "Engraving Text", "operator": "CONTAINS", "value": "cat" }
  ]
}
```

<table><thead><tr><th width="267.4921875">Key</th><th>Values</th></tr></thead><tbody><tr><td><code>action</code></td><td><code>show</code> / <code>hide</code></td></tr><tr><td><code>match</code></td><td><code>any</code> (at least one condition must be true) / <code>all</code> (every condition must be true)</td></tr><tr><td><code>conditions[].option_label</code></td><td>Must exactly match another option's <code>Option_name (Label_product)</code> <strong>in the same option set</strong></td></tr><tr><td><code>conditions[].operator</code></td><td><code>IS</code>, <code>IS NOT</code>, <code>LESS_THAN</code>, <code>GREATER_THAN</code>, <code>CONTAINS</code>, <code>DOES NOT CONTAIN</code></td></tr><tr><td><code>conditions[].value</code></td><td>Must match one of the referenced option's real values (for choice-list types)</td></tr></tbody></table>

A condition can also use the customer's **Shopify variant** as its source. Instead of `option_label`, it has `"source": "shopify_variant"`:

```json
{
  "action": "show",
  "match": "any",
  "conditions": [
    { "source": "shopify_variant", "operator": "IS", "value": "41816231542953" },
    { "source": "shopify_variant", "operator": "CONTAINS", "value": "White / Large" }
  ]
}
```

* With `IS` / `IS NOT`, `value` is the numeric Shopify **variant ID** (use the **Search variant ID** tool on the Import/Export page to find it).
* With `CONTAINS` / `DOES NOT CONTAIN`, `value` is free text matched against the variant name, including spaces and uppercase/lowercase.
* `LESS_THAN` and `GREATER_THAN` are not available for this source.
* You can mix `option_label` and `shopify_variant` conditions in the same `conditions` list.
* Shopify variant conditions only take effect on Storefront V2. See [Advanced conditional logic (Shopify variant)](https://docs.optis.me/product-options/advanced-setup/advanced-conditional-logic-shopify-variant).

Requirements: the option set needs **at least 2 options** (unless every condition uses `shopify_variant`) for conditional logic to make sense, and every `option_label` must reference a real option that already exists in that same set. Anything malformed (bad JSON, an unrecognized `action`/`match`, a missing key) is treated as a **warning** — the row still imports, this field is simply dropped.

#### 7.3 `Font_picker_settings`

```json
{
  "typeFontSelection": "specific",
  "font_picker_values": ["ABeeZee", "AR One Sans", "Abel"],
  "displayFontPicker": "dropdown",
  "listOptionApplied": ["Enter custom text"]
}
```

<table><thead><tr><th width="293.65625">Key</th><th>Values</th></tr></thead><tbody><tr><td><code>typeFontSelection</code></td><td><code>all</code> / <code>specific</code></td></tr><tr><td><code>font_picker_values</code></td><td>Array of font name strings</td></tr><tr><td><code>displayFontPicker</code></td><td><code>dropdown</code> / <code>button_horizontal</code> / <code>button_vertical</code></td></tr><tr><td><code>listOptionApplied</code></td><td>Array of other options' <code>Option_name (Label_product)</code> this font choice should apply to</td></tr></tbody></table>

Only `font_picker_values` is strictly required; the rest fall back to sensible defaults if omitted or malformed.

#### 7.4 `File_upload_settings`

```json
{ "file_type": "custom", "custom_file_type": "png, img", "max_files": 5 }
```

<table><thead><tr><th width="257.94140625">Key</th><th>Values</th></tr></thead><tbody><tr><td><code>file_type</code></td><td><code>all</code> / <code>image</code> / <code>document</code> / <code>custom</code></td></tr><tr><td><code>custom_file_type</code></td><td>Comma-separated extensions, only meaningful when <code>file_type</code> is <code>custom</code> — otherwise leave as <code>""</code> (the key must still be present)</td></tr><tr><td><code>max_files</code></td><td>Number</td></tr></tbody></table>

#### 7.5 `Date_time_settings`

```json
{
  "date_time_mode": "date_picker",
  "date_time_config": [
    { "allDay": true, "name": "Monday", "selected": true, "timeEnd": "23:59", "timeStart": "00:00" },
    { "allDay": true, "name": "Tuesday", "selected": true, "timeEnd": "23:59", "timeStart": "00:00" },
    { "allDay": true, "name": "Wednesday", "selected": true, "timeEnd": "23:59", "timeStart": "00:00" },
    { "allDay": true, "name": "Thursday", "selected": true, "timeEnd": "23:59", "timeStart": "00:00" },
    { "allDay": false, "name": "Friday", "selected": true, "timeEnd": "20:59", "timeStart": "00:00" },
    { "allDay": false, "name": "Saturday", "selected": true, "timeEnd": "20:59", "timeStart": "00:00" },
    { "allDay": false, "name": "Sunday", "selected": true, "timeEnd": "20:59", "timeStart": "00:00" }
  ],
  "display_date_time_type": 1,
  "time_format": 0,
  "overall_format": 1,
  "disable_past_date": 3,
  "disable_past_date_type": 3,
  "disable_specific_date": ["04 Jun 2026", "13 Jun 2026"],
  "disable_date_range": ["10 Jun 2026 to 12 Jun 2026"],
  "disable_all_past_date": 1
}
```

* The four keys `date_time_mode`, `display_date_time_type`, `time_format`, `overall_format` must be present.
* `date_time_mode` is `date_picker` or `date_range`.
* The other numeric codes (which weekday/format/deactivation option each number means) mirror whatever the Date & Time option editor's UI currently offers — **the safest way to get these exactly right is to configure one Date & Time option in the editor, export that option set, and copy its `Date_time_settings` cell as your template.**

#### 7.6 `Live_mockup` / `Background`

Both are advanced "live preview" settings tied to the option editor's mockup feature.

* `Live_mockup` requires the top-level keys `enable`, `size_config`, `pos_config`, `transforms`.
* `Background` requires `type`, `overlay_mode`, `width`, `height` (`type`: `MAIN_PRODUCT` / `CUSTOM`; `overlay_mode`: `FIRST_IMAGE_FROM_START` / `OVERLAY_AFTER_FILL_VALUE`).

These have deep nested shapes that aren't meant to be hand-written. **Configure the live preview in the option editor once, export that option set, and reuse its `Live_mockup`/`Background` cells verbatim** rather than writing them from scratch.

#### 7.7 `Phone_settings`

```json
{"country_selection":"selected","country_values":["US","CA"],"default_country":"CA","validate_phone_number":true}
```

<table><thead><tr><th width="257.94140625">Key</th><th>Values</th></tr></thead><tbody><tr><td><code>country_selection</code></td><td><code>all</code> / <code>selected</code></td></tr><tr><td><code>country_values</code></td><td>Array of 2-letter ISO country codes (e.g. <code>US</code>, <code>GB</code>, <code>VN</code>); only used with <code>selected</code></td></tr><tr><td><code>default_country</code></td><td>A 2-letter ISO country code, inside <code>country_values</code> when <code>selected</code></td></tr><tr><td><code>validate_phone_number</code></td><td><code>true</code> / <code>false</code></td></tr></tbody></table>

Unknown country codes are dropped; a missing or invalid `default_country` falls back to the first allowed country. Leave the cell empty to import the option with **All countries**, your store's country as default and validation off. Files exported before this column existed (44 columns) can still be imported.

***

### 8. Common errors & how to fix them

These are the exact messages you'll see on the review screen.

#### Hard errors (row is skipped until fixed)

<table><thead><tr><th width="256.44921875">Message</th><th>What it means / how to fix</th></tr></thead><tbody><tr><td>Required field is missing</td><td>A required column (see the <strong>Required</strong> column in <a href="#id-5.-full-field-reference">§5</a>) is blank on a row where it must be filled in</td></tr><tr><td>Unknown option type "…"</td><td><code>Option_type</code> doesn't match any value in <a href="#id-6.-option-types-reference">§6</a> — check spelling/casing</td></tr><tr><td>Invalid value "…" (Status)</td><td><code>Status</code> must be <code>Live</code> or <code>Inactive</code></td></tr><tr><td>Expected "Yes" or "No", got "…"</td><td>A Yes/No column has something else in it</td></tr><tr><td>Expected a number, got "…"</td><td>A numeric column has non-numeric text in it</td></tr><tr><td>Invalid JSON</td><td>A JSON column (<code>Phone_settings</code>, <code>Font_picker_settings</code>, <code>File_upload_settings</code>, <code>Date_time_settings</code>, <code>Live_mockup</code>, <code>Background</code>, <code>Visibility (Conditional_logic)</code>) isn't valid JSON at all — check for missing quotes/commas/brackets</td></tr><tr><td>Expected a JSON object</td><td>The JSON parsed, but isn't an object (e.g. it's an array or a bare string)</td></tr><tr><td>Missing required keys: …</td><td>The JSON object is missing one of the required keys listed in §7</td></tr><tr><td>"conditions" must be an array</td><td><code>Visibility (Conditional_logic)</code>'s <code>conditions</code> key isn't a list</td></tr><tr><td>Each condition must have "option_label", "operator", and "value"</td><td>One of the condition objects is missing a required key</td></tr><tr><td>Invalid price type "…"</td><td><code>Option_price_type</code> must be <code>Extra fee</code> or <code>Upsell product</code></td></tr><tr><td>Invalid swatch title display type / group display type / helptext position</td><td>The cell doesn't match one of that field's allowed values — see <a href="#id-5.-full-field-reference">§5</a> for the exact list</td></tr><tr><td>Duplicate option name "…" in option set "…"</td><td>Two options in the same set share the same <code>Option_name (Label_product)</code></td></tr><tr><td>Duplicate Option_id "…" in option set "…"</td><td>Two options in the same set share the same <code>Option_id</code> — only the first is kept</td></tr><tr><td>Duplicate Option_set_id "…" in the file</td><td>The same <code>Option_set_id</code> appears in more than one non-contiguous block — they're merged into the first occurrence</td></tr><tr><td>Option_set_id "…" doesn't match this option set — moved / kept in this set</td><td>An option row's <code>Option_set_id</code> disagrees with the set it's positioned under — the importer resolves it by ID where possible</td></tr><tr><td>Max_quantity must be greater than Min_quantity</td><td>Fix the two values so max > min (both are otherwise dropped)</td></tr><tr><td>Max_selections_characters must be greater than Min_selections_characters</td><td>Same idea, for character limits</td></tr><tr><td>Conditional logic requires at least 2 options in the set</td><td>Add another option to the set, or remove the <code>Visibility</code> rule</td></tr><tr><td>Conditional logic references option "…", which doesn't exist in this set</td><td>Fix <code>option_label</code> to match a real option's name in the same set</td></tr><tr><td>Conditional logic value "…" doesn't match any value of option "…"</td><td>Fix <code>value</code> to match one of that option's real choice values</td></tr><tr><td>Conditional logic action/match must be "Show"/"Hide" or "Any"/"All"</td><td>Fix the <code>action</code>/<code>match</code> key's value</td></tr></tbody></table>

#### Warnings (row still imports; only the flagged cell is cleared)

| Banner                                                                                 | Meaning                                                                                          |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Products / Collections / Variants / Customers / Product tags / Customer tags not found | The named item doesn't exist on this store — double-check spelling, or that it's the right store |
| `Swatch_value` images unreachable                                                      | The image URL couldn't be fetched — check the link is public and correct                         |
| Invalid column width (falls back to 100)                                               | `Column_width` wasn't one of the six allowed values                                              |
| Invalid priority (falls back to 0)                                                     | `Priority` wasn't a whole number 0–99                                                            |
| Invalid font picker display/selection mode (reset to default)                          | `Font_picker_settings`'s `displayFontPicker`/`typeFontSelection` had an unrecognized value       |

***

### 9. Tips & best practices

* **Start from a real file.** Use the sample template or (better) a file you just exported — don't build the header row from scratch.
* **Don't touch the header row.** Column names and order must match exactly.
* **Multi-line cells use in-cell newlines, not new spreadsheet rows.** In Excel/Google Sheets, press <kbd>Alt</kbd>+<kbd>Enter</kbd> (Windows) or <kbd>⌥</kbd>+<kbd>Return</kbd> (Mac) inside a cell for `Products` (specific-product lists) or `Option_in_group`.
* **`Option_in_group` names must match exactly.** Case and spacing matter — copy the option's `Option_name (Label_product)` verbatim.
* **For the advanced JSON fields** (`Phone_settings`, `Font_picker_settings`, `File_upload_settings`, `Date_time_settings`, `Live_mockup`, `Background`), configure one real example in the option editor UI and export it — copy that cell rather than hand-writing the JSON.
* **Test with a small file first**, especially the first time you import into a store — a 2–3 row file surfaces formatting mistakes faster than a 500-row one.
* **It's safe to leave and come back.** The review screen persists for a while and the job itself lives 24 hours server-side — but if you sit on the review screen too long without confirming or cancelling, it will expire.

***

### 10. Limits at a glance

| Limit                        | Value    |
| ---------------------------- | -------- |
| Accepted file type           | `.csv`   |
| Max file size                | 20 MB    |
| Max data rows                | 50,000   |
| Concurrent imports per store | 1        |
| Job lifetime                 | 24 hours |
|                              |          |


# Change product image on option selection

When a customer picks an option value, the main product image switches to the image you matched with that value. No page reload, no extra apps.

This works with these option types: **Checkbox, Dropdown menu, Dropdown menu with thumbnails, Radio button, Switch, Swatch and Button**.

### How it works

OPTIS matches by **alt text**. You set the alt text of a product image to be the same as the label of an option value. When the customer picks that value, OPTIS finds the image with that alt text and shows it.

For example, if an option has the value **Red**, give your red product image the alt text `Red`.

### Set it up

**Step 1: Turn on the feature**

1. Open the option set and select the option.
2. Under **Advanced settings**, check **Change image on option selection**.
3. Save the option set.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fgit-blob-7e0fcf073418df4bf2ccb7477543740dabbd00fe%2Fchange-image-on-option-selection-checkbox.png?alt=media" alt=""><figcaption></figcaption></figure>

**Step 2: Add the alt text to your product images**

1. Copy the label of an option value from the option set.
2. In Shopify admin, go to **Products** and open the product.
3. Click the image you want to show for that value and paste the label as its alt text.
4. Repeat for each value. Save the product.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fgit-blob-c1be2f8194ab42eb6452d1b6002f572b5046b177%2Fchange-image-on-option-selection-alt-text.png?alt=media" alt=""><figcaption></figcaption></figure>

**Step 3: Use a supported product gallery**

The image only changes on galleries that show one main image at a time, such as a **carousel** or a **thumbnail** gallery. A **grid** gallery shows all images at once, so it does not work.

1. In Shopify admin, go to **Online Store > Themes** and click **Customize**.
2. Open a product page and select the product media section (named **Product media** in some themes).
3. Change **Type** to **Carousel** (or another gallery type with one main image). Setting names can be different in your theme.
4. Click **Save**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fgit-blob-646d528b0c5c1866d17bebd2508758505126714a%2Fchange-image-on-option-selection-gallery-type.png?alt=media" alt=""><figcaption></figcaption></figure>

**Step 4: Test on your store**

Open the product page, pick each value and check that the image changes.

{% hint style="info" %}
**Note**

* The alt text must match the value label exactly, including capital letters, spaces and punctuation.
* If two images have the same alt text, the first one is used. If no image matches, the image does not change.
* If two options on a product have a value with the same label, both match the same image. Use different labels for different images.
* Each product needs its own images with matching alt text, even when the option set is used on many products.
* If you rename a value, update the alt text of your images to match.
  {% endhint %}

### Use cases

#### Use case 1: Change the product image by selection

**The store.** A store sells soft knit sweaters. Each sweater comes in several colors.

**The goal.** Customers should see the sweater in the color they pick, not one fixed photo.

**Setup.**

1. Create an option **Color** with the type **Swatch**. Add the values **Taupe**, **Black** and **Cream**.
2. Under **Advanced settings**, check **Change image on option selection**.
3. In Shopify admin, open the sweater product. Give the taupe sweater photo the alt text `Taupe`, the black one `Black` and the cream one `Cream`.

**What the customer sees.**

* The customer picks **Black**. The main image changes to the black sweater photo.
* The product also has a variant with its own photo. The customer picks that variant and the image changes to the variant photo. They pick **Cream** next and the image changes to the cream photo. The image always follows the last thing the customer picked.
* The customer unselects the swatch, or the option is hidden by conditional logic. The image goes back to the variant image, or the main product image.
* The customer adds the sweater to the cart. The cart shows the usual product or variant image.

#### Use case 2: Change the image and show Live Preview on it

**The store.** A store sells hoodies. Customers can add their own text to the hoodie.

**The goal.** Customers should see their text on the hoodie in the color they pick, before they buy.

**Setup.**

1. Create an option **Color** with the type **Swatch**, and values **Grey** and **Navy**. Check **Change image on option selection**.
2. Create an option **Your text** with the type **Text box**. Turn on Live Preview and set it to show on **All product images**.
3. In Shopify admin, give the grey hoodie photo the alt text `Grey` and the navy hoodie photo `Navy`.

**What the customer sees.**

* The customer types a text. It appears on the hoodie.
* The customer picks **Navy**. The main image changes to the navy hoodie, and the text is drawn on the navy hoodie.
* The customer adds to cart. The cart image is the navy hoodie with the text, the image shown at that moment.
* If the customer edits the option in the cart with **Edit option on cart page**, changing the color changes the image and the text again.

See [Product Personalizer - Live Mockup Settings](https://docs.optis.me/product-options/advanced-setup/product-personalizer-live-mockup-settings).

### Troubleshooting

| Problem                                         | What to check                                                                                        |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| The image doesn't change                        | Copy the value label again and paste it as the alt text. Check for extra spaces at the start or end. |
| The image doesn't change on a grid gallery      | Change the product gallery type to Carousel or another gallery with one main image. See Step 3.      |
| It works on one product but not another         | The other product has no image with matching alt text.                                               |
| It worked, then stopped                         | You renamed the value. Update the alt text of the image.                                             |
| Wrong image shows                               | Two images may share the same alt text, or two options have a value with the same label.             |
| The image changes on some themes but not others | Contact us through live chat. Some themes need extra setup.                                          |

Still need help? Contact us through live chat and we will check your theme for free.


# How to Use "Upsell product"? Link Stock and Price of Shopify Variant to Option Value

Our app supports **product option inventory management**, allowing specific options to be **grayed out when out of stock** and ensuring that inventory updates automatically when a customer purchases an option.

This feature, called **"Upsell product"** links an option to a specific Shopify variant, syncing stock and price automatically. This feature is available in our **$19.99/month plan**:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FAK68ljYRSUqxVoeLRMB2%2FScreenshot%20(1).png?alt=media&amp;token=caa6eafd-7c6a-4a05-9ce3-28da39f29141" alt=""><figcaption></figcaption></figure>

## Step-by-Step Guide to Set Up "Upsell product" <a href="#id-2-step-by-step-guide-to-set-up-upsell-product" id="id-2-step-by-step-guide-to-set-up-upsell-product"></a>

### Step 1: Create Draft Products with Variants <a href="#id-2-step-by-step-guide-to-set-up-upsell-product" id="id-2-step-by-step-guide-to-set-up-upsell-product"></a>

1. In your Shopify store, create a draft product with different variants.
2. Assign stock levels and prices to each variant.

* Example:
* **Black variant:** Stock = **5**, Price = **$0** (only tracks stock).
* **White variant:** Stock = **0**, Price = **$1000** (tracks both stock and price).<br>

<figure><img src="https://storage.crisp.chat/users/upload/session/-/4/6/c/9/46c94fa4c7cb6000/image1ejgxli_odqxsn.png" alt=""><figcaption></figcaption></figure>

### Step 2: Assign Variants to Product Options <a href="#id-3-step-2-assign-variants-to-product-options" id="id-3-step-2-assign-variants-to-product-options"></a>

1. In the option set editor, open the option and set **Add-on** to **Upsell product**. Use the **Add-on** column of the **Option values** table (click **Columns** to show it), or **Add-on** in **Option settings** for single-value options.
2. Click the variant field (**Search product**) and, in the **Select product variant** window, select the corresponding Shopify variant for each option value. The window shows each variant's SKU and available quantity (or **Not tracked**).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FIbPNWHCAg05hWu8MEp45%2FScreenshot%20(2).png?alt=media&amp;token=ccf34e71-ec00-4787-8c0a-c10fbeb0cb94" alt=""><figcaption></figcaption></figure>

### Step 3: View the Result on Your Storefront <a href="#id-3-step-3-view-the-result-on-your-storefront" id="id-3-step-3-view-the-result-on-your-storefront"></a>

* If a variant is out of stock, the assigned option will be **grayed out** automatically.
* If a variant has stock (for example 4 stocks), then the option linked with this variant will also have 4 stocks

<figure><img src="https://storage.crisp.chat/users/upload/session/-/4/6/c/9/46c94fa4c7cb6000/image1bljvlz_ymv3ug.png" alt=""><figcaption></figcaption></figure>

* When a customer purchases an option, the inventory updates in real-time (e.g., black stock reduces from 5 to 4).

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/image_4z6xs8.png" alt=""><figcaption></figcaption></figure>

#### **Optional: Keep Variants in Draft Mode** <a href="#id-3-optional-keep-variants-in-draft-mode" id="id-3-optional-keep-variants-in-draft-mode"></a>

* If you do not want these variants to appear as active products in your store, you can keep them in **draft mode** in Shopify.

By following these steps, you can **prevent customers from selecting out-of-stock options** while keeping your inventory automatically updated!


# OPTIS Product Options - Developer Integration Guide

### Overview <a href="#id-2-overview" id="id-2-overview"></a>

The OPTIS Product Options app exposes a global JavaScript object `BSS_PO.currentSelectedOptions` that contains real-time information about customer-selected product options, including prices, validation status, quantities, and detailed breakdowns. This guide explains how third-party developers can integrate with and read data from our app.

### Data Structure <a href="#id-2-data-structure" id="id-2-data-structure"></a>

#### BSS\_PO.currentSelectedOptions <a href="#id-3-bsspocurrentselectedoptions" id="id-3-bsspocurrentselectedoptions"></a>

The main data object contains the following structure:

```
BSS_PO.currentSelectedOptions = {
  byOptionId: {},              // Options indexed by option ID
  byLabel: {},                 // Options indexed by label name
  byOptionSetId: {},           // Options grouped by option set ID
  allValues: [],               // Flat array of all selected options
  quantities: {},              // NEW: Quantity data for each option value
  totalPriceAddOn: 0,          // Total price add-on from all options
  totalVariantPriceAddOn: 0,   // Total variant-based price add-on
  variantPriceAddOn: [],       // Array of variant price add-ons
  priceBreakdown: {},          // Detailed price breakdown by option
  validation: {                // Validation status for required options
    isValid: true,
    requiredOptions: [],
    missingOptions: [],
    validOptions: [],
    errors: []
  },
  timestamp: "2023-..."        // Last update timestamp
}
```

#### NEW: Quantity Data Structure <a href="#id-3-new-quantity-data-structure" id="id-3-new-quantity-data-structure"></a>

The `quantities` object stores quantity information for each option value:

```
quantities: {
  // By option label and value combination
  "Size_Large": 2,
  "Color_Red": 1,
  
  // By option ID (for easy lookup)
  "optionId_123": {
    "Large": 2,
    "Medium": 1
  },
  "optionId_124": {
    "Red": 1,
    "Blue": 3
  }
}
```

### Enhanced Option Value Structure <a href="#id-2-enhanced-option-value-structure" id="id-2-enhanced-option-value-structure"></a>

Each option value now includes quantity and pricing information:

```
{
  value: "Large",
  label: "Size",
  index: 0,
  quantity: 2,              // NEW: Selected quantity for this value
  unitPrice: 5.00,          // NEW: Price per unit
  unitVariantPrice: 0,      // NEW: Variant price per unit
  price: 10.00,             // Total price (unitPrice × quantity)
  variantPrice: 0,          // Total variant price (unitVariantPrice × quantity)
  id: 123
}
```

### API Methods <a href="#id-2-api-methods" id="id-2-api-methods"></a>

We provide a comprehensive API through `BSS_PO.getSelectedOptions` for easy data access:

#### Basic Data Access <a href="#id-3-basic-data-access" id="id-3-basic-data-access"></a>

**Get All Selected Options**

```
// Get all selected options with price and quantity information
const allOptions = BSS_PO.getSelectedOptions.all();
console.log(allOptions);
// Returns: [{ 
//   label: "Size", 
//   value: "Large", 
//   quantity: 2,
//   unitPrice: 5.00,
//   price: 10.00, 
//   variantPrice: 0, 
//   id: 123, 
//   index: 0 
// }, ...]
```

**Get Options by Label**

```
// Get all values for a specific option (useful for multi-select options)
const colorOptions = BSS_PO.getSelectedOptions.byLabel("Color");
console.log(colorOptions);
// Returns: [{ 
//   value: "Red", 
//   quantity: 1,
//   unitPrice: 2.00,
//   price: 2.00, 
//   variantPrice: 0, 
//   id: 124, 
//   index: 0 
// }]

// Get single value for radio/dropdown options
const selectedSize = BSS_PO.getSelectedOptions.getValue("Size");
console.log(selectedSize); // "Large"

// Get multiple values for checkbox options
const selectedFeatures = BSS_PO.getSelectedOptions.getValues("Features");
console.log(selectedFeatures); // ["Waterproof", "Extended Warranty"]
```

**Check Option Selection**

```
// Check if a specific option value is selected
const isRedSelected = BSS_PO.getSelectedOptions.isSelected("Color", "Red");
console.log(isRedSelected); // true
```

#### NEW: Quantity Methods <a href="#id-3-new-quantity-methods" id="id-3-new-quantity-methods"></a>

**Get Quantity Information**

```
// Get quantity for a specific option value
const sizeQuantity = BSS_PO.getSelectedOptions.getQuantity("Size", "Large");
console.log(`Large size quantity: ${sizeQuantity}`); // 2

// Get all quantities for an option
const sizeQuantities = BSS_PO.getSelectedOptions.getQuantities("Size");
console.log(sizeQuantities); // { "Large": 2, "Medium": 1 }

// Get quantity by option ID
const optionQuantities = BSS_PO.getSelectedOptions.getQuantitiesByOptionId(123);
console.log(optionQuantities); // { "Large": 2, "Medium": 1 }

// Get total quantity across all options
const totalQuantity = BSS_PO.getSelectedOptions.getTotalQuantity();
console.log(`Total items: ${totalQuantity}`); // 4
```

#### Enhanced Price Information <a href="#id-3-enhanced-price-information" id="id-3-enhanced-price-information"></a>

**Get Price Data with Quantity**

```
// Get total price add-on from all options (includes quantity multiplication)
const totalPrice = BSS_PO.getSelectedOptions.getTotalPriceAddOn();
console.log(`Total extra: $${totalPrice.toFixed(2)}`);

// Get unit price vs total price for specific option value
const unitPrice = BSS_PO.getSelectedOptions.getUnitPriceByValue("Size", "Large");
const totalPrice = BSS_PO.getSelectedOptions.getPriceByValue("Size", "Large");
const quantity = BSS_PO.getSelectedOptions.getQuantity("Size", "Large");
console.log(`Unit price: $${unitPrice}, Quantity: ${quantity}, Total: $${totalPrice}`);

// Get price breakdown with quantity details
const breakdown = BSS_PO.getSelectedOptions.getPriceBreakdownWithQuantities();
console.log(breakdown);
/* Returns:
{
  "Size": {
    values: [{
      value: "Large",
      quantity: 2,
      unitPrice: 5.00,
      unitVariantPrice: 0,
      price: 10.00,
      variantPrice: 0,
      extraPriceType: 0
    }],
    totalPrice: 10.00,
    totalVariantPrice: 0,
    totalQuantity: 2
  }
}
*/
```

**Get Comprehensive Price Summary with Quantities**

```
const priceSummary = BSS_PO.getSelectedOptions.getPriceSummary();
console.log(priceSummary);
/* Returns:
{
  total: 15.00,
  totalVariant: 5.00,
  grandTotal: 20.00,
  totalQuantity: 3,              // NEW: Total quantity across all options
  formattedTotal: "15.00",
  formattedVariantTotal: "5.00",
  formattedGrandTotal: "20.00",
  details: [
    {
      label: "Size",
      price: 10.00,
      variantPrice: 0,
      quantity: 2,                 // NEW: Total quantity for this option
      unitPrice: 5.00,             // NEW: Average unit price
      formattedPrice: "10.00",
      values: [{ 
        value: "Large", 
        quantity: 2,               // NEW: Quantity for this specific value
        unitPrice: 5.00,           // NEW: Unit price for this value
        price: 10.00, 
        variantPrice: 0 
      }]
    }
  ]
}
*/
```

#### Validation <a href="#id-3-validation" id="id-3-validation"></a>

**Check Validation Status**

```
// Check if all required options are selected
const isValid = BSS_PO.getSelectedOptions.isValid();
console.log(`Form valid: ${isValid}`);

// Get validation summary
const validation = BSS_PO.getSelectedOptions.getValidationSummary();
console.log(validation);
/* Returns:
{
  isValid: false,
  totalRequired: 3,
  totalMissing: 1,
  totalValid: 2,
  message: "1 required option(s) need to be selected",
  missingLabels: ["Color"],
  errors: ["Color is required and must be selected."],
  details: { required: [...], missing: [...], valid: [...] }
}
*/

// Check specific option requirements
const isColorRequired = BSS_PO.getSelectedOptions.isRequired("Color");
const isColorMissing = BSS_PO.getSelectedOptions.isMissing("Color");
```

**Get Validation Errors**

```
const errors = BSS_PO.getSelectedOptions.getValidationErrors();
errors.forEach(error => console.error(error));
```

#### Enhanced Formatted Output <a href="#id-3-enhanced-formatted-output" id="id-3-enhanced-formatted-output"></a>

**Get Formatted Strings with Quantities**

```
// Get formatted string of all selections with prices and quantities
const formatted = BSS_PO.getSelectedOptions.getFormattedSelectionsWithPrices();
console.log(formatted);
// "Size: Large (×2, +10.00) | Color: Red (×1, +2.00) | Features: Waterproof, Extended Warranty (×1, +5.00)"

// Get formatted string with detailed quantity breakdown
const detailedFormat = BSS_PO.getSelectedOptions.getFormattedSelectionsDetailed();
console.log(detailedFormat);
// "Size: Large (2 units @ $5.00 each = $10.00) | Color: Red (1 unit @ $2.00 = $2.00)"
```

### NEW: Complete API Methods for Quantity Support <a href="#id-2-new-complete-api-methods-for-quantity-support" id="id-2-new-complete-api-methods-for-quantity-support"></a>

Here are the additional methods added to support quantity functionality:

```
BSS_PO.getSelectedOptions = {
  // ... existing methods ...

  // === QUANTITY METHODS ===
  
  // Get quantity for specific option value
  getQuantity: (label, value) => {
    const quantityKey = `${label}_${value}`;
    return BSS_PO.currentSelectedOptions?.quantities[quantityKey] || 0;
  },

  // Get all quantities for an option label
  getQuantities: (label) => {
    const options = BSS_PO.currentSelectedOptions?.byLabel[label] || [];
    const quantities = {};
    options.forEach(option => {
      quantities[option.value] = option.quantity || 1;
    });
    return quantities;
  },

  // Get quantities by option ID
  getQuantitiesByOptionId: (optionId) => {
    return BSS_PO.currentSelectedOptions?.quantities[`optionId_${optionId}`] || {};
  },

  // Get total quantity across all options
  getTotalQuantity: () => {
    const allValues = BSS_PO.currentSelectedOptions?.allValues || [];
    return allValues.reduce((total, option) => total + (option.quantity || 1), 0);
  },

  // === ENHANCED PRICE METHODS WITH QUANTITY ===

  // Get unit price for specific option value (before quantity multiplication)
  getUnitPriceByValue: (label, value) => {
    const breakdown = BSS_PO.currentSelectedOptions?.priceBreakdown[label];
    if (breakdown && breakdown.values) {
      const valueObj = breakdown.values.find(v => v.value === value);
      return valueObj ? (valueObj.unitPrice || 0) : 0;
    }
    return 0;
  },

  // Get unit variant price for specific option value
  getUnitVariantPriceByValue: (label, value) => {
    const breakdown = BSS_PO.currentSelectedOptions?.priceBreakdown[label];
    if (breakdown && breakdown.values) {
      const valueObj = breakdown.values.find(v => v.value === value);
      return valueObj ? (valueObj.unitVariantPrice || 0) : 0;
    }
    return 0;
  },

  // Get price breakdown including quantity details
  getPriceBreakdownWithQuantities: () => {
    const breakdown = BSS_PO.currentSelectedOptions?.priceBreakdown || {};
    const enhanced = {};
    
    Object.entries(breakdown).forEach(([label, data]) => {
      enhanced[label] = {
        ...data,
        totalQuantity: data.values.reduce((sum, v) => sum + (v.quantity || 1), 0),
        averageUnitPrice: data.values.length > 0 ? 
          data.values.reduce((sum, v) => sum + (v.unitPrice || 0), 0) / data.values.length : 0
      };
    });
    
    return enhanced;
  },

  // === ENHANCED FORMATTED OUTPUT ===

  // Get formatted selections with quantity details
  getFormattedSelectionsDetailed: () => {
    const allValues = BSS_PO.currentSelectedOptions?.allValues || [];
    const grouped = {};

    allValues.forEach(option => {
      if (!grouped[option.label]) {
        grouped[option.label] = [];
      }
      grouped[option.label].push({
        value: option.value,
        quantity: option.quantity || 1,
        unitPrice: option.unitPrice || 0,
        price: option.price || 0
      });
    });

    return Object.entries(grouped).map(([label, items]) => {
      const values = items.map(item => {
        if (item.quantity > 1) {
          return `${item.value} (${item.quantity} units @ $${item.unitPrice.toFixed(2)} each = $${item.price.toFixed(2)})`;
        } else {
          return item.price > 0 ? 
            `${item.value} (+$${item.price.toFixed(2)})` : 
            item.value;
        }
      }).join(', ');
      return `${label}: ${values}`;
    }).join(' | ');
  }
};
```

### Event System <a href="#id-2-event-system" id="id-2-event-system"></a>

#### Listen for Option Changes with Quantity Information <a href="#id-3-listen-for-option-changes-with-quantity-information" id="id-3-listen-for-option-changes-with-quantity-information"></a>

```
// Listen for any option selection changes
document.addEventListener('BSSOptionSelectionChanged', (event) => {
  const { 
    selectedOptions, 
    quantities,           // NEW: Quantity data
    totalPriceAddOn, 
    priceBreakdown 
  } = event.detail;
  
  console.log('Options changed:', selectedOptions);
  console.log('Quantities:', quantities);
  console.log('New total price:', totalPriceAddOn);
  console.log('Price breakdown:', priceBreakdown);
  
  // Update your UI with quantity information
  updateCartSummary(totalPriceAddOn, quantities);
});

// Listen for validation failures
document.addEventListener('BSSOptionValidationFailed', (event) => {
  const { validation, missingOptions, errors } = event.detail;
  
  console.log('Validation failed:', validation);
  console.log('Missing options:', missingOptions);
  
  // Show validation errors to user
  displayValidationErrors(errors);
});

// Listen for price changes (includes quantity-based price calculations)
document.addEventListener('BSSchangeProductPrice', (event) => {
  console.log('Product price changed, recalculate total with quantities');
  
  // Update your price display with quantity considerations
  const newTotal = BSS_PO.getSelectedOptions.getTotalPriceAddOn();
  const totalQuantity = BSS_PO.getSelectedOptions.getTotalQuantity();
  updatePriceDisplay(newTotal, totalQuantity);
});
```

### Cart Page Integration <a href="#id-2-cart-page-integration" id="id-2-cart-page-integration"></a>

#### Detecting Option Changes on Cart Page <a href="#id-3-detecting-option-changes-on-cart-page" id="id-3-detecting-option-changes-on-cart-page"></a>

On the cart page, customers can edit their product options and quantities. To detect these changes:

```
// Listen for cart changes (additions, removals, option edits, quantity changes)
window.addEventListener('cart_changed', (event) => {
  const { newCart, oldCart, changedCartItems } = event.detail;
  
  console.log('Cart changed:', {
    newCart,
    oldCart, 
    changedItems: changedCartItems
  });
  
  // Fetch updated cart data to get latest option and quantity information
  fetchUpdatedCartData();
});

// Function to fetch and process updated cart data with quantity information
async function fetchUpdatedCartData() {
  try {
    const response = await fetch('/cart.js');
    const cartData = await response.json();
    
    // Process cart items to extract option and quantity information
    cartData.items.forEach(item => {
      // Check for OPTIS option properties
      const optionProperties = {};
      
      // Extract option data from cart item properties
      Object.keys(item.properties || {}).forEach(key => {
        // OPTIS stores option data in properties with specific patterns
        if (key.includes('_bssPrice') || key.includes('_bssVariants') || 
            key.includes('_bssCustomAttributes') || key.includes('_bssQuantities')) {
          try {
            optionProperties[key] = JSON.parse(item.properties[key]);
          } catch (e) {
            optionProperties[key] = item.properties[key];
          }
        }
      });
      
      console.log(`Item ${item.key} options:`, optionProperties);
      console.log(`Item ${item.key} cart quantity:`, item.quantity);
      
      // Update your UI based on the new option and quantity data
      updateCartItemDisplay(item.key, optionProperties, item.quantity);
    });
    
  } catch (error) {
    console.error('Error fetching cart data:', error);
  }
}

// Example: Update cart item display with quantity information
function updateCartItemDisplay(itemKey, optionData, cartQuantity) {
  const cartItemElement = document.querySelector(`[data-cart-item="${itemKey}"]`);
  if (cartItemElement && optionData._bssPrice) {
    const extraPrice = optionData._bssPrice.extra || 0;
    const quantities = optionData._bssQuantities || {};
    
    // Update price display with quantity considerations
    const priceElement = cartItemElement.querySelector('.item-price');
    if (priceElement) {
      console.log(`Item ${itemKey} has extra price: $${extraPrice}`);
      console.log(`Item ${itemKey} option quantities:`, quantities);
      console.log(`Item ${itemKey} cart quantity:`, cartQuantity);
    }
  }
}
```

#### Enhanced Cart Data Structure <a href="#id-3-enhanced-cart-data-structure" id="id-3-enhanced-cart-data-structure"></a>

Cart items now include quantity information for options:

```
// Example cart item with OPTIS option and quantity data
{
  "key": "39772975595588:abc123",
  "id": 39772975595588,
  "properties": {
    "Size": "Large (×2)",
    "Color": "Red (+$5.00)",
    "_bssPrice": "{\"extra\":15.00}",
    "_bssQuantities": "{\"Size_Large\":2,\"Color_Red\":1}",  // NEW: Quantity data
    "_bssVariants": "{\"Size\":{\"id\":\"39772975595588\",\"quantity\":2}}",
    "_bssCustomAttributes": "{\"Size\":\"Large\",\"Color\":\"Red\"}"
  },
  "quantity": 1,  // This is the cart line item quantity
  "variant_id": 39772975595588
}
```

### Practical Examples <a href="#id-2-practical-examples" id="id-2-practical-examples"></a>

#### Example 1: Quantity-Aware Price Calculator <a href="#id-3-example-1-quantity-aware-price-calculator" id="id-3-example-1-quantity-aware-price-calculator"></a>

```
function calculateOptionPricing() {
  const allOptions = BSS_PO.getSelectedOptions.all();
  let totalCost = 0;
  let breakdown = [];
  
  allOptions.forEach(option => {
    const itemCost = option.price; // Already includes quantity multiplication
    totalCost += itemCost;
    
    breakdown.push({
      option: option.label,
      value: option.value,
      quantity: option.quantity,
      unitPrice: option.unitPrice,
      totalPrice: itemCost,
      formatted: option.quantity > 1 ? 
        `${option.value} (${option.quantity}× $${option.unitPrice.toFixed(2)} = $${itemCost.toFixed(2)})` :
        `${option.value} (+$${itemCost.toFixed(2)})`
    });
  });
  
  return { totalCost, breakdown };
}
```

#### Example 2: Inventory Management Integration <a href="#id-3-example-2-inventory-management-integration" id="id-3-example-2-inventory-management-integration"></a>

```
function checkInventoryAvailability() {
  const selectedOptions = BSS_PO.getSelectedOptions.all();
  const inventoryWarnings = [];
  
  selectedOptions.forEach(option => {
    // Check if requested quantity exceeds available inventory
    const availableStock = getInventoryForOption(option.label, option.value);
    
    if (option.quantity > availableStock) {
      inventoryWarnings.push({
        option: `${option.label}: ${option.value}`,
        requested: option.quantity,
        available: availableStock,
        message: `Only ${availableStock} units available for ${option.label}: ${option.value}`
      });
    }
  });
  
  return inventoryWarnings;
}
```

#### Example 3: Dynamic Pricing Based on Quantity <a href="#id-3-example-3-dynamic-pricing-based-on-quantity" id="id-3-example-3-dynamic-pricing-based-on-quantity"></a>

```
function applyQuantityDiscounts() {
  const options = BSS_PO.getSelectedOptions.all();
  let adjustedTotal = 0;
  
  options.forEach(option => {
    let finalPrice = option.price;
    
    // Apply quantity-based discounts
    if (option.quantity >= 10) {
      finalPrice *= 0.9; // 10% discount for 10+ items
    } else if (option.quantity >= 5) {
      finalPrice *= 0.95; // 5% discount for 5+ items
    }
    
    adjustedTotal += finalPrice;
    
    console.log(`${option.label}: ${option.value} - ${option.quantity} units`);
    console.log(`Original: $${option.price.toFixed(2)}, Discounted: $${finalPrice.toFixed(2)}`);
  });
  
  return adjustedTotal;
}
```

### Troubleshooting <a href="#id-2-troubleshooting" id="id-2-troubleshooting"></a>

#### Common Issues <a href="#id-3-common-issues" id="id-3-common-issues"></a>

1. **BSS\_PO is undefined**: The app hasn't loaded yet. Make sure OPTIS is installed and enabled in the theme app extension.
2. **Quantity data is missing**: Ensure you're using the updated version of OPTIS that supports quantity tracking. Check that quantity inputs are properly configured for your option types.
3. **Price calculations seem incorrect**: Remember that prices in the API are already multiplied by quantities. Use `unitPrice` if you need the per-unit cost.
4. **Quantity not updating**: Quantity changes trigger the same events as other option changes. Listen for `BSSOptionSelectionChanged` events to detect quantity modifications.
5. **Validation not working with quantities**: Validation checks if options are selected, not their quantities. Implement custom quantity validation based on your business rules.
6. **Cart quantities vs option quantities**: Cart line item quantity is different from individual option quantities. A single cart item can have multiple option values with different quantities each.

#### Best Practices <a href="#id-3-best-practices" id="id-3-best-practices"></a>

1. **Always check for quantity data**: Not all option types support quantities. Default to 1 if quantity data is unavailable.
2. **Use unit prices for custom calculations**: When implementing custom pricing logic, use `unitPrice` and multiply by `quantity` yourself.
3. **Listen to events for real-time updates**: Don't poll for changes; use the provided event system for better performance.
4. **Cache expensive calculations**: If you're doing complex quantity-based calculations, cache results and only recalculate when the `BSSOptionSelectionChanged` event fires.
5. **Validate quantities in your code**: Implement business logic to ensure quantities make sense for your use case (minimum/maximum quantities, inventory checks, etc.)


# Limit Min/Max Selectors in Checkbox/ Button Options/ Swatch

*This feature lets you set limits on how many different values customers can select in one option (for example, "Pick up to 3 toppings").*

{% hint style="info" %}
Available on the **Advanced** plan and above. It works with **Checkbox**, **Button**, **Swatch**, **Switch**, **Dropdown menu** and **Dropdown with thumbnail** options. A **Radio button** always allows a single choice.
{% endhint %}

#### Steps to Manage <a href="#id-3-steps-to-manage" id="id-3-steps-to-manage"></a>

1. **Select the option** (Checkbox, Button, Swatch, Switch, Dropdown menu or Dropdown with thumbnail) in your option set.
2. **Scroll to the Quantity** section.
3. **Tick** "Limit how many different option values can be selected". On a Dropdown menu, this is also what lets customers select more than one value.
4. **Enter the Min selected option values and Max selected option values.** The limit also applies to the number of default option values you set.
5. **Click Save** to apply your settings.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F6HKF2Uvuklk0zRwrMeaG%2FScreenshot%20(3).png?alt=media&amp;token=468e8c34-86d6-4b61-8e0d-b3aff843bef5" alt=""><figcaption></figcaption></figure>

If a customer selects fewer or more values than allowed, a message is shown on the product page. You can change the wording of these messages in **Settings > Translation Texts > Default text customization > Product page** (**Min selector** and **Max selector**).


# How to upload image in paragraph / pop-up modal?

*You want to upload an image in your paragraph or pop-up modal option type. The result will look like the image below*

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F6hsvoiu9NgkbAYlcFo1u%2FScreenshot%20(4).png?alt=media&amp;token=65f4bf20-184e-486a-86e0-0bad1ce915ef" alt=""><figcaption></figcaption></figure>

#### Step by step guide to upload an image <a href="#id-3-step-by-step-guide-to-upload-an-image" id="id-3-step-by-step-guide-to-upload-an-image"></a>

1. Go to Paragraph, or pop-up modal option type, where you need to upload the image

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FaZB9piOG3MAfmHRTafh6%2FScreenshot%20(5).png?alt=media&amp;token=c41646db-e624-4a9c-a464-3575b4377326" alt=""><figcaption></figcaption></figure>

2. Click Insert > Image

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F6fKqbEDTffiKiAlH2pLT%2FScreenshot%20(6).png?alt=media&amp;token=5984b7fa-fdd8-45af-b4d4-35265654d80d" alt=""><figcaption></figcaption></figure>

3. Click the "Browse File" icon

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FeMrINLtlw1r1I5g78d5C%2FScreenshot%20(7).png?alt=media&amp;token=3a913e2d-26e9-4f1f-a05b-1624731a191f" alt=""><figcaption></figcaption></figure>

4. You can select an existing file from **Shopify files / Optis files** or upload a new image directly from your device -> then click **Done**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FJnM2EXR9TATKeYSkdr4t%2FScreenshot%20(8).png?alt=media&amp;token=228dd5c1-f354-40d4-a3c3-f9887a679b2e" alt=""><figcaption></figcaption></figure>

5. You can also adjust the size. Then finally, click save.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FsHgvzB8iUriZvLqBRW9C%2FScreenshot%20(9).png?alt=media&amp;token=4924ea58-c602-449c-b370-c59f7329c77e" alt=""><figcaption></figcaption></figure>

6. You have the image upload successfully

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fcq40tA3AwI15Pj1sBuxU%2FScreenshot%20(10).png?alt=media&amp;token=68cda0bb-5ba1-4414-aeb4-f4b31d72d6e4" alt=""><figcaption></figcaption></figure>

<br>


# Set a Default Value for an Option Field

This feature lets you set a default value for an option, so it's automatically selected or filled in when customers view your product page.

{% hint style="info" %}
Default values are available on the **Advanced** plan and above.
{% endhint %}

### **Where it is available:**

* **Options with a list of values** - Dropdown menu, Dropdown with thumbnail, Checkbox, Radio button, Switch, Button and Swatch: use the **Default** column of the **Option values** table (see the steps below).
* **Text options** - Text box, Text area, Number field, Email and Phone: type the value in **Default value** (next to **Placeholder text**) in the option's **Content** tab.
* **Font picker** - choose the font in **Default value**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FuRlwDeyaLeNxiqMi8Wjg%2FScreenshot%20(4).png?alt=media&amp;token=bb78602e-10e9-4506-a777-64e9fa188b70" alt=""><figcaption></figcaption></figure>

### **Steps:**

1. In the **Option set**, click on the element you want to adjust.
2. Under the **Option values** section, locate the specific value you want to set as default
3. Toggle on the switch in the **Default** column next to that option value
4. Click **Save** to finish.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FpzNNiq0DU3nUc7ujTYut%2FScreenshot%20(11).png?alt=media&amp;token=20b35cda-50b4-41ff-9ec1-e440829ca09a" alt=""><figcaption></figcaption></figure>

**Result:** The default option will appear selected on your storefront page.

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_161qzrl.png" alt=""><figcaption></figcaption></figure>


# Make the option required before adding to cart

This feature ensures that customers must select an option before they can add the product to their cart.

#### **Steps:**

1. In the **Option set edit** page, locate the element you want to make mandatory.
2. Under the **Option label**, find and enable the "**Required field**" checkbox.
3. Click **Save** to apply the changes.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FIxoD9NFvgF12fNRmYBc5%2FScreenshot%20(5).png?alt=media&amp;token=64a6fdcb-3d46-449e-98fa-8c4b41eff4b5" alt=""><figcaption></figcaption></figure>

**Result:**

* Required options will display a **red asterisk (\*)** next to the option name on the storefront.
* If a customer clicks Add to cart without making a selection, a warning message will appear to prompt them.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FhAcDT1urxcfYMrZyj6Yu%2FScreenshot%20(6).png?alt=media&amp;token=3eeac80f-f8a8-4170-861d-f6c3224ae511" alt=""><figcaption></figcaption></figure>

**Customize the look and the message**

* The color of the asterisk is set in **Settings > Design Settings > Color > Required character**.
* The warning text (default: "Option {{Option name}} is required") can be changed in **Settings > Translation Texts > Default text customization > Product page**.
* In **Settings > General Settings > Widget setting**, turn on **Scroll to first message error** to scroll customers to the first missing option when they click **Add to cart**.


# Change the “--please select--” on dropdown thumbnail

1. In the **Dropdown option** **type,** scroll down to **Default text**, then change the text in there

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FhBGLiZgYxnuzyWhIL625%2FScreenshot%20(11).png?alt=media&amp;token=5b88d451-2618-4145-88a5-98a7400aade1" alt=""><figcaption></figcaption></figure>

2. Click **Save**, and **re-check on the product page**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fods100VzDlsSJnyKRrE8%2FScreenshot%20(29).png?alt=media&amp;token=d6c13827-9b98-4827-b2ea-4fc363ba3bac" alt=""><figcaption></figcaption></figure>


# Limit Characters for Text Input

***This feature lets you set a character limit for Text box, Text area and Email fields.***

**Steps:**

1. In the **Option set** , click on the text element you want to adjust.
2. Find **Min character** and **Max character**, and enter the character limit in these fields.
3. Click **Save** to finish

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fh756AcTfaL8uybOB2vZI%2FScreenshot%20(13).png?alt=media&amp;token=2b835f42-570b-4fa1-bf2b-dadb0bdc45e7" alt=""><figcaption></figcaption></figure>

4. Go to the **Settings** > **General Settings**
5. Enable **Character count for text box** (under **Option type setting > Text input**). When a **Max character** is set, a counter such as "12/50 characters" appears under the field.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FNXxGp1Cg20sbLu805Pu4%2FScreenshot%20(14).png?alt=media&amp;token=01aeef58-b248-46ab-ae5a-1cee70fd903e" alt=""><figcaption></figcaption></figure>

**Final result on storefront:**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fq4HZ3ZANl9rWXbTWoWny%2FScreenshot%20(15).png?alt=media&amp;token=a8696ffa-1d59-4473-b54f-3390b5aa4229" alt=""><figcaption></figcaption></figure>


# Change option set position on product page

1. Go to **Settings > General Settings > Widget position** and click **Change widget position**. Your Shopify theme editor opens in a new tab on the product template with the OPTIS block ready to place.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FtOvlVN2UIUqH7KPmcXZr%2FScreenshot%20(16).png?alt=media&amp;token=0f521905-2b57-4d86-8283-d3e740257df1" alt=""><figcaption></figcaption></figure>

2. You will see the **OPTIS Product Options** block in the theme editor

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F40Tj3LVQya90lr3mLjkT%2FScreenshot%20(17).png?alt=media&amp;token=ef0ddd1f-223f-4dee-b281-9cbe5670fee0" alt=""><figcaption></figcaption></figure>

3. **Drag the OPTIS Product Options block** to the wanted position, for example, **below the price**. The change will **reflect in the preview** on the right

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fs9gGQMprhDBItD0aYslV%2FScreenshot%20(18).png?alt=media&amp;token=16cd4b1b-bb18-4aa2-ae0f-601ba6be35cf" alt=""><figcaption></figcaption></figure>

4. Click **Save**, and **re-check on the product page**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FmDaLQeyIddXnKRGjhkeZ%2FScreenshot%20(19).png?alt=media&amp;token=6f2356fe-eafe-4d1b-b123-50f4fb7fefa2" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Some themes do not support moving the block. If the option set cannot be placed where you want it, contact us via live chat or <support@optis.me> and we will help for free.
{% endhint %}


# Settings overview

Use **Settings** to change how OPTIS options look and behave on your whole store. Settings has three tabs: **General Settings**, **Design Settings** and **Translation Texts**. On wide screens a **Preview** next to the form shows your changes (product page options, cart or checkout). Click **Save** to apply your changes or **Discard** to cancel them.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F5WCMAoCGmYiKQkhQs6GY%2Fimage.png?alt=media&amp;token=48079c80-a962-43a7-acc4-45d736a54696" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Settings are locked on the Free plan. Upgrade to the **Advanced** plan or above to edit them. See [Plans and feature availability](https://docs.optis.me/product-options/getting-started/plans-and-features).
{% endhint %}

## General Settings

### Option type setting

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FNn81sSHdw6kWwT25XSwq%2Fimage.png?alt=media&amp;token=bc222ed4-f337-46e3-8f1e-73dd229f93a5" alt=""><figcaption></figcaption></figure>

| Setting                                       | Choices (default in bold)                                       | Learn more                                                                                                                                            |
| --------------------------------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Add-on display**                            | **After selecting option values**, or **Next to option values** | [Manage add-on](https://docs.optis.me/product-options/advanced-setup/manage-add-on-additional-fee-for-option)                                         |
| **Text input > Character count for text box** | **On** or off                                                   | [Limit Characters for Text Input](https://docs.optis.me/product-options/faq/limit-characters-for-text-input)                                          |
| **Swatches > Shape**                          | **Square** or **Circle**                                        | [Display color swatch element in a round shape](https://docs.optis.me/product-options/customize-design/display-color-swatch-element-in-a-round-shape) |
| **Swatches > Show swatch tooltip**            | **On** or off                                                   | [Show the swatch tooltip as an image](https://docs.optis.me/product-options/customize-design/show-the-swatch-tooltip-as-an-image)                     |
| **Swatches > Hover display**                  | **Text only**, **Image only** or **Text & image**               | [Show the swatch tooltip as an image](https://docs.optis.me/product-options/customize-design/show-the-swatch-tooltip-as-an-image)                     |
| **File upload display**                       | **1 file per row** or **Multiple files per row**                | [File Upload](https://docs.optis.me/product-options/20-option-types/others/file-upload)                                                               |

### SKU setting

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLVcwbHAaPO4wUugHHgMl%2Fimage.png?alt=media&amp;token=22fcd7d6-6c5b-4caf-b492-b8880c20fc10" alt=""><figcaption></figcaption></figure>

* **SKU Type**: **Both variants and OPTIS options** (default), **Only OPTIS options** or **Only variants**.
* **SKU Separators**: the character that joins the variant SKU and the option SKUs (default `-`).

See [How does Product Option SKU works?](https://docs.optis.me/product-options/customize-design/how-does-product-option-sku-works).

### Widget position

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FbhjpEJyFyH88Zhcpzs67%2Fimage.png?alt=media&amp;token=e46181d0-5b70-4bf3-85f7-0540cdabebb2" alt=""><figcaption></figcaption></figure>

Click **Change widget position** to open your Shopify theme editor with the OPTIS block ready to place on the product page, or click **Tutorial**. See [Change option set position on product page](https://docs.optis.me/product-options/faq/change-option-set-position-on-product-page).

### Widget setting

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FooXpYkfzmxfdE7s9a5O3%2Fimage.png?alt=media&amp;token=f761e01b-e646-4b8a-91c0-1df8cc2f8911" alt=""><figcaption></figcaption></figure>

* **Widget height** - tick **Set widget height limit** to give the options area a maximum height in pixels (200 by default; enter 200 or more). When the options are taller than that, a scrollbar appears inside the options area. It is off by default.
* **Alignment** - **Left** (default), **Middle** or **Right**.
* **Option value & message**:
  * **Show selected option value next to title** - shows the value the customer selected (for example a swatch) next to the option name (off by default).
  * **Scroll to first message error** - when a customer clicks **Add to cart** or **Buy it now** with a missing or invalid option, the page scrolls to the first error (on by default).

## Design Settings

The **Design Settings** tab has three sections. Each one has a **Reset** button to go back to the default look.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FX9YZjFdQhFbBURyq2K4L%2Fimage.png?alt=media&amp;token=3f6796ca-0a35-4db8-86a4-c1e3dd7043aa" alt=""><figcaption></figcaption></figure>

* **Color** - the colors of option titles, values, required character, error messages, help text, text inputs, dropdowns, checkbox/radio, switches, buttons and swatches. See [Change the color for options](https://docs.optis.me/product-options/customize-design/change-the-color-for-options).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FVgA0jrocvJXsQKxDREUe%2Fimage.png?alt=media&amp;token=0f2f2ddc-17e4-4317-8364-ed6f116709cc" alt=""><figcaption></figcaption></figure>

* **Border** - **Border size** and **Border radius** for text inputs, buttons, dropdowns, swatches, quantity buttons and edit buttons.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FbonMtuzgug1BsbAsURFh%2Fimage.png?alt=media&amp;token=72f387d7-8d21-4670-b5c8-e633bb9546af" alt=""><figcaption></figcaption></figure>

* **Size** (**Text & option size**) - the text size and weight of option titles, values, add-on messages, help text and tooltips and error messages, and the size of text inputs, text areas, buttons, dropdowns, thumbnails, checkbox/radio, switches and swatches. See [Set up the text & option size](https://docs.optis.me/product-options/customize-design/set-up-the-text-and-option-size).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F7iybVuwAYOufFYv2DCi0%2Fimage.png?alt=media&amp;token=4402ad28-359c-4093-a8d4-91ccc1aeb188" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FXO0iZjvj38Fqg9liRPCl%2Fimage.png?alt=media&amp;token=0eca0a4f-f898-469f-a86e-9538ae10b291" alt=""><figcaption></figcaption></figure>

## Translation Texts

Change the built-in texts of OPTIS and translate your option sets into other languages. See [Translate your option sets and default texts](https://docs.optis.me/product-options/advanced-setup/translate-your-option-sets-and-default-texts).

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FtCSDPbhkPXysSm5vYLye%2Fimage.png?alt=media&amp;token=467d81c8-759d-4b2f-8b55-2cf1884162a7" alt=""><figcaption></figcaption></figure>


# How does Product Option SKU works?

#### Where to add SKU for OPTIS options? <a href="#id-3-where-to-add-sku-for-optis-options" id="id-3-where-to-add-sku-for-optis-options"></a>

1. For all the **Text input** options, **Color picker, File upload, Font picker**, you can add SKU for OPTIS options in the **Option settings**:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FVLAcQJy21WTV3gqECJ9t%2FScreenshot%20(20).png?alt=media&amp;token=338349b0-4646-459c-8240-954508e4179d" alt=""><figcaption></figcaption></figure>

2. For all the **Check list** options (except for Font picker) and **Swatch** options, you can add SKU for OPTIS options in the **Option values**:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F1NCX8DFqIjVSNbCEZ34M%2FScreenshot%20(30).png?alt=media&amp;token=089daa94-ab00-440f-811e-5b049bce087b" alt=""><figcaption></figcaption></figure>

#### How does it work with Shopify variants SKU? <a href="#id-3-how-does-it-work-with-shopify-variants-sku" id="id-3-how-does-it-work-with-shopify-variants-sku"></a>

When customer buys the product with both Shopify variants and OPTIS option, the SKU will show like this:

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_tld9lf.png" alt=""><figcaption></figcaption></figure>

#### Can I customize the SKU display on cart page? <a href="#id-3-can-i-customize-the-sku-display-on-cart-page" id="id-3-can-i-customize-the-sku-display-on-cart-page"></a>

Yes. Go to **Settings > General Settings > SKU setting** and choose the **SKU Type**:

* **Both variants and OPTIS options** (default)
* **Only OPTIS options**
* **Only variants**

Use **SKU Separators** to choose the character that joins the variant SKU and the option SKUs (default: `-`). The preview under the field shows the result, for example `variantsku-sku-sku`.

{% hint style="info" %}
Adding SKUs to options is available on the **Advanced** plan and above. Date & time options do not have a SKU field.
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fh0iZbCRoTwwE1uv467gJ%2FScreenshot%20(21).png?alt=media&amp;token=10d41253-d9bb-4ce2-9567-abbb130c6847" alt=""><figcaption></figcaption></figure>


# Show the swatch tooltip as an image

1. Our final result is to make the image appear larger when hovering on the swatches

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_1hqm27h.png" alt=""><figcaption></figcaption></figure>

2. Go to **Settings > General Settings**, find **Option type setting > Swatches** and turn on **Show swatch tooltip**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FHMIs4V1Cjx3rhyhK5J36%2FScreenshot%20(31).png?alt=media&amp;token=be583739-18e8-43af-b919-7b1f6af3dad3" alt=""><figcaption></figcaption></figure>

3. Change **Hover display** to **Text & image** or **Image only** (the default is **Text only**)

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FydHtQOR1peglpHUjXFKo%2FScreenshot%20(22).png?alt=media&amp;token=fe0b1709-0b7d-450a-8212-d45fd0188d27" alt=""><figcaption></figcaption></figure>


# Translate the “Choose File” of File Upload

1. Firstly, go to **Settings > Translation Texts**

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_f3qhij.png" alt=""><figcaption></figcaption></figure>

2. Open **Default text customization > Product page**, scroll to the **File upload** group and change the text in the **Choose file** box. You can also change the **Dropzone instruction** ("or drop file to upload") there.

<figure><img src="https://storage.crisp.chat/users/helpdesk/website/22429817467a0000/image_5gcu3l.png" alt=""><figcaption></figcaption></figure>


# Display color swatch element in a round shape

1. Go to **Settings > General Settings**, find **Option type setting > Swatches** and change **Shape** to **Circle** (the default is **Square**)

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FGCIqHNZtUSPdAxnjBuci%2FScreenshot%20(24).png?alt=media&amp;token=f237813f-7112-4b1e-a992-d39555d18d4e" alt=""><figcaption></figcaption></figure>

2. Click **Save,** and **re-check on the product page**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FXFQksR9EEi58X49nkh2H%2FScreenshot%20(25).png?alt=media&amp;token=07e09a65-21fd-4a55-886c-50788d5ceef3" alt=""><figcaption></figcaption></figure>

<div><figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FzQGEiyvCy2fgFt8TKe1d%2FScreenshot%202026-08-10%20203258.png?alt=media&amp;token=83501578-71cd-4137-a987-fdcc636e0285" alt=""><figcaption></figcaption></figure> <figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FYqyJqn6IUesTvHKqeTnJ%2FScreenshot%202026-08-10%20203339.png?alt=media&amp;token=1cca86d1-e786-45b8-9fc9-d0d46312b79e" alt=""><figcaption></figcaption></figure></div>


# Set up the text & option size

* To adjust the Text Size, please go to **Settings > Design Settings > Text & Option Size**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F81FNwGpKJzN1A8DS4mr7%2FScreenshot%20at%20Aug%2009%2020-12-27.png?alt=media&amp;token=1c5cff2b-9afb-4ee2-83a8-e5ab75ce813e" alt=""><figcaption></figcaption></figure>

* To adjust the Option Size, scroll down to the **Option Size section** -> Set up **size** for each option type

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FQcma1VWFjHeBA37AYoue%2FScreenshot%20at%20Aug%2009%2020-13-30.png?alt=media&amp;token=db63aba9-2fe7-44ca-8e20-81cd95f36c02" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Design Settings are available on the **Advanced** plan and above. Each section has a **Reset** button to go back to the default sizes. See [Settings overview](https://docs.optis.me/product-options/customize-design/settings-overview).
{% endhint %}

**What you can change**

* **Text size**: for **Option Title**, **Option Value**, **Add-on Message**, **Help Text & Tooltip** and **Error Message**, set the **Font size** and the **Font weight** (**Normal** or **Bold**).
* **Option size**:
  * **Text Input**: **Width**, **Height**, **Textarea width** and **Textarea height**.
  * **Choice List**: **Button padding top/bottom** and **Button padding left/right**; **Dropdown width** and **Dropdown height**; **Thumbnail width** and **Thumbnail height**; **Checkbox/radio size** and **Checkbox/radio image**; **Switch width** and **Switch height**.
  * **Swatch**: **Width** and **Height**.


# Change the color for options

1. Firstly, go to **Settings > Design Settings > Color**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F3vGom2R2GQc6M0W44KMH%2FScreenshot%20(27).png?alt=media&amp;token=9dfbef3f-0da3-493d-85da-0f2be75b1c72" alt=""><figcaption></figcaption></figure>

2. Change the color for your option elements, and then click **Save**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FBH9s7muULvfoSBGErEcl%2FScreenshot%20(32).png?alt=media&amp;token=387dc36a-7169-4367-91a2-5070dc22a02b" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Design Settings are available on the **Advanced** plan and above. Each section has a **Reset** button to go back to the default colors. See [Settings overview](https://docs.optis.me/product-options/customize-design/settings-overview).
{% endhint %}

**What you can change in Color**

* **General**: Price add-on, Option title, Option value, Required character, Help text content, Help text background, Error message, Quantity button and Edit button.
* **Text Input**: Textbox border, Textbox border hover and Textbox background.
* **Choice List**: Dropdown border, Dropdown background and Dropdown hover; Checkbox / radio hover and Checkbox / radio active; Switch background and Switch active.
* **Button**: Button text, Button text hover and Button text active; Background, Background hover and Background active; Border, Border hover and Border active.
* **Swatch**: Swatch border, Swatch border hover and Swatch border active; Hover background and Hover text.

Use the **Border** tab to change the **Border size** and **Border radius** of text inputs, buttons, dropdowns, swatches, quantity buttons and edit buttons.


# Welcome to OPTIS Color Swatch!

Welcome to **OPTIS Color Swatch** - the easiest way to transform standard Shopify variants into **beautiful, visual swatches** across your storefront.

Our app helps you display **color and image swatches, swatch cards, pill swatches, buttons, and dropdowns** on product pages, collection pages, and even the homepage, making it easier for customers to explore variants and choose the right option with confidence.

## 🚀 What OPTIS Color Swatch can do for you

OPTIS Color Swatch helps you turn Shopify’s default variant selectors into a **visual, intuitive, and conversion-friendly experience**.

With OPTIS, you can:

* 🎨 Display product options as [**Auto image swatches**](https://docs.optis.me/swatch/variant-display/auto-image-swatch), [**Custom swatches**](https://docs.optis.me/swatch/variant-display/custom-swatch) (solid colors, two-color splits, or your own images), [**Swatch cards**](https://docs.optis.me/swatch/variant-display/swatch-card), [**Pill swatches**](https://docs.optis.me/swatch/variant-display/pill-swatch), [**Buttons**](https://docs.optis.me/swatch/variant-display/button), [**Buttons without border**](https://docs.optis.me/swatch/variant-display/button#button-without-border), or [**Dropdowns**](https://docs.optis.me/swatch/variant-display/dropdown)
* 🪄 Fill in swatch colors in one click with [**Auto-assign swatch**](https://docs.optis.me/swatch/variant-display/auto-assign-color-swatch), or import and export swatch values in a spreadsheet with **Bulk update**
* 📝 Show [**option and value descriptions**](https://docs.optis.me/swatch/variant-display/option-and-value-descriptions) from product or variant metafields — below or beside the option, in a tooltip, or in a popup
* 🖼️ Show [**variant images**](https://docs.optis.me/swatch/variant-images/show-images-per-variant) so the gallery only displays images that match the selected variant — on product pages and [collection pages](https://docs.optis.me/swatch/variant-images/variant-images-on-collection-pages)
* 🏷️ Highlight variants with [**Variant badges**](https://docs.optis.me/swatch/variant-badges/variant-badges-overview) such as *New* or *Hot*, plus store-wide [**Automatic badges**](https://docs.optis.me/swatch/global-settings/automatic-badges) for Sold out, Low stock, New, and On sale
* 🔗 [**Group multiple products into a single variant experience**](https://docs.optis.me/swatch/product-groups/show-separate-products-as-variants-with-product-groups) (combine listings), with [sub-categories](https://docs.optis.me/swatch/product-groups/product-group-sub-categories), [bulk create](https://docs.optis.me/swatch/product-groups/bulk-create-product-groups), and [CSV export](https://docs.optis.me/swatch/product-groups/export-product-groups-to-csv)
* 🛍️ Show swatches on **product pages, collection pages, and featured sections** — on collection pages, shoppers can [preview a variant's image on hover](https://docs.optis.me/swatch/frequently-asked-questions/how-to-change-image-on-hovering), and you choose what a [swatch click](https://docs.optis.me/swatch/global-settings/collection-click-behaviour) does
* 🎛️ Customize the look in [**Styling**](https://docs.optis.me/swatch/styling/styling-overview) with a live preview and separate settings for product and collection pages, desktop and mobile
* ⚙️ Fine-tune store-wide behavior in [**Global settings**](https://docs.optis.me/swatch/global-settings/global-settings-overview): [out-of-stock display](https://docs.optis.me/swatch/global-settings/out-of-stock-display), [tooltips](https://docs.optis.me/swatch/global-settings/tooltip), [No preselect](https://docs.optis.me/swatch/global-settings/no-preselect), [Hide single variant](https://docs.optis.me/swatch/global-settings/hide-single-variant), [Custom CSS](https://docs.optis.me/swatch/global-settings/custom-css), and more

This app is designed to work smoothly with most Shopify themes and requires no coding to get started — new stores also get a step-by-step setup wizard on the app dashboard.

✨ View our demo store: [OPTIS Color Swatch demo store](https://optis-color-swatch-variant.myshopify.com/) (password: 1)

## 💬Need help?

Our support team is always here to help including custom setup when possible.

* Live chat inside the app
* 📩 Email us at [support@optis.me](https://mail.google.com/mail/?view=cm\&fs=1\&to=support@optis.me\&subject=OPTIS%20Support)
* Fast, human replies (no bots 👀)


# Changelog

A quick look at what's new in **OPTIS Color Swatch** — newest updates first.

***

### 🧩 Sprint 3: Product Group sub-categories, automatic badges & more

<mark style="color:$primary;">**August 21, 2026**</mark>

* **Product Groups**: split a group into [sub-categories](https://docs.optis.me/swatch/product-groups/product-group-sub-categories), [bulk create](https://docs.optis.me/swatch/product-groups/bulk-create-product-groups) many groups at once from a name pattern, tag, or metafield, and [export](https://docs.optis.me/swatch/product-groups/export-product-groups-to-csv) all your groups to CSV. The Product Groups search box now also matches by product name.
* Global settings: added [Automatic badges](https://docs.optis.me/swatch/global-settings/automatic-badges) — **Low stock**, **New**, and **On sale**, alongside the existing Auto sold-out badge.
* Global settings: added [Collection page click behaviour](https://docs.optis.me/swatch/global-settings/collection-click-behaviour) — choose whether clicking a swatch on a collection page changes the image or opens the product.
* Global settings: [Tooltip](https://docs.optis.me/swatch/global-settings/tooltip) can now **display a large image** for image swatches on the product page, not just a text label.
* Variant Images: added [Variant images on collection pages](https://docs.optis.me/swatch/variant-images/variant-images-on-collection-pages) — the variant-aware gallery now works on collection cards too.
* Configure Variants: added [Option and value descriptions](https://docs.optis.me/swatch/variant-display/option-and-value-descriptions) — pull descriptions from product/variant metafields and show them below, beside, in a tooltip, or in a popup.
* Styling: added separate **Desktop** and **Mobile** tabs so layout and hide-extra settings can differ per device.
* Global settings page reorganized into grouped sections (Swatch state, Variant selection behaviour, Automatic badges, Position and images, Advanced) for easier navigation.

### 🚦 Sprint 2: Variant pre-selection & hide single variant

<mark style="color:$primary;">**July 28, 2026**</mark>

* Added [No preselect](https://docs.optis.me/swatch/global-settings/no-preselect) in Global settings — require shoppers to actively choose an option before Add to Cart is enabled, instead of the first variant being auto-selected. Includes a customizable gate message (supports the `{{option_name}}` token) and dropdown placeholder text.
* Added [Hide single variant](https://docs.optis.me/swatch/global-settings/hide-single-variant) — hide an option's selector (per Product page or Collection page) once it's down to just one selectable value, showing it as read-only text instead.
* Faster swatch rendering on collection pages.

### 🚀 Sprint 1: Variant badges, onboarding wizard & more

<mark style="color:$primary;">**July 6, 2026**</mark>

* Added **Variant badges** — pin labels like *New*, *Hot*, or *Sold out* on swatches, plus a store-wide sold-out badge in Global settings. See [Variant badges](https://docs.optis.me/swatch/variant-badges/variant-badges-overview) and [Automatic badges](https://docs.optis.me/swatch/global-settings/automatic-badges).
* **Onboarding** — added a step-by-step guided setup wizard on the dashboard for new stores.
* Updated the logic and priority order of the **Auto-assign swatch** button. See [Auto-assign color swatch](https://docs.optis.me/swatch/variant-display/auto-assign-color-swatch).
* Global settings: added color and direction options for **Strike-through**, plus a new **Gray out** display type. See [Out-of-stock display](https://docs.optis.me/swatch/global-settings/out-of-stock-display).
* Global settings: added a **Two-color swatch split** setting. See [Two-color swatch split](https://docs.optis.me/swatch/global-settings/two-color-swatch-split).
* **Out-of-stock display** and **Non-existent display** are now separate settings. See [Out-of-stock display](https://docs.optis.me/swatch/global-settings/out-of-stock-display) and [Non-existent display](https://docs.optis.me/swatch/global-settings/non-existent-display).

### 🧩 Standardized Product Group preview

<mark style="color:$primary;">**June 3, 2026**</mark>

The Product Group setup preview now matches exactly how the group looks on your storefront — image, title, price, swatch, and display style all update live as you change settings.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-24739841527b7e0c75762fc0b79bc7f317f10af7%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### 🖱️ Hover-to-preview on collection pages

<mark style="color:$primary;">**April 27, 2026**</mark>

Added a Collection Page Styling option: hovering over a swatch, button, or dropdown on a collection page now updates the product image and price instantly, without clicking (desktop only — mobile keeps click-to-select).

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-52fc7926c0dca1b9df0c9e29260cd30c056aa269%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### 🔗 Compatibility with the [REZ app](https://apps.shopify.com/rez-back-in-stock-notify-me/reviews?ratings%5B%5D=5)

<mark style="color:$primary;">**April 9, 2026**</mark>

Swatches now display correctly for merchants who also use the [REZ app](https://apps.shopify.com/rez-back-in-stock-notify-me/reviews?ratings%5B%5D=5).

### 💊 Pill swatch display style

<mark style="color:$primary;">**April 3, 2026**</mark>

Added **Pill** as a new swatch display style, alongside color swatch, image swatch, button, and dropdown.

### 🪄 Auto-assign colors & swatch search

<mark style="color:$primary;">**March 17, 2026**</mark>

One-click **Auto-assign color** now matches variant names (e.g. "Lavender") to color swatches automatically. A new search box also makes it easy to find a variant in a long swatch list.

### 🎨 2-color swatch

<mark style="color:$primary;">**March 10, 2026**</mark>

Merchants can now assign two colors to a single swatch (e.g. "Black/Pink"), shown as a split-color swatch on the storefront — useful for option values that combine two colors.

{% hint style="warning" %}
2-color swatch is a **paid plan** feature for new merchants. Existing paid merchants keep access.
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-3549ddcb13313d7cf763116851f949e1cedac423%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### 🌐 Multi-language admin support

<mark style="color:$primary;">**March 3, 2026**</mark>

The app's admin interface now supports translations, replacing hardcoded text with a translation system so more languages can be added over time.

### 💳 Pricing plan launch

<mark style="color:$primary;">**January 20, 2026**</mark>

OPTIS Color Swatch moved to a paid pricing plan, with free and paid tiers. Merchants who installed the app before this date keep their existing features (grandfathered).

{% hint style="info" %}
See [Pricing Plans](https://docs.optis.me/swatch/subscription-and-billing/pricing-plans) for plan details.
{% endhint %}

### 🖼️ Variant Images feature

<mark style="color:$primary;">**January 20, 2026**</mark>

Overhauled how the app determines and swaps the product image shown for a selected variant on the storefront, including better handling of neighboring variant images.

### 🧩 Swatch Card display style & out-of-stock handling

<mark style="color:$primary;">**October 20, 2025**</mark>

Added the **Swatch Card** storefront display style, plus refined out-of-stock handling — unavailable variants are strike-through or grayed out, with correct option counts and native Shopify option hiding.

### 🎛️ Custom CSS section

<mark style="color:$primary;">**October 6, 2025**</mark>

Added a **Custom CSS** field in Global Settings so merchants can fine-tune swatch appearance with their own styles.

### 🏷️ Product Groups

<mark style="color:$primary;">**September 18, 2025**</mark>

Launched **Product Groups**: merchants can group related products together so shoppers can switch between them (e.g. different styles of the same product) directly from the product page, with shared variant/swatch display.

### 🎠 Carousel swatch style with tooltips

<mark style="color:$primary;">**July 29, 2025**</mark>

Added a carousel-style layout for displaying extra option values, with hover tooltips showing the option value name.

### 👀 Quick view support & expanded theme compatibility

<mark style="color:$primary;">**July 9, 2025**</mark>

Variant swatches and options now render correctly inside "Quick view" popups, and the app added support for several more free and paid Shopify themes.

### 🖼️ Image swatch display type

<mark style="color:$primary;">**June 18, 2025**</mark>

Added support for image-based swatches — using a product or variant image instead of a flat color — as a display option alongside color swatches.

### 🚀 App launch

<mark style="color:$primary;">**April 8, 2025**</mark>

OPTIS Color Swatch launches. Merchants can turn plain variant option lists into color swatches, image swatches, buttons, or dropdowns, configure them from the app dashboard, and preview them live on the storefront.


# Quickstart

{% stepper %}
{% step %}

### Activate the app

* In the **App Dashboard**, go to **Setup Guide** → click **Activate the app**

→ You’ll be redirected to **App Embed** in the Shopify Theme Editor

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-22c6d15a5212cbd0cacc854a2b84894f754540ec%2Fquickstart-app-embed-theme-editor.png?alt=media" alt="OPTIS Color Swatch App embed in the Shopify Theme Editor"><figcaption></figcaption></figure>

* Turn on the toggle and click **Save**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-cc8e362c28440d5bca45592ae053b41827621734%2Fquickstart-app-embed-toggle-save.png?alt=media" alt="App embed toggle turned on, with the Save button"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Optional (Recommended for testing):** If you want to enable the app on a draft theme instead, go to **Online Store → Themes → Edit theme (selected theme) → App embeds**, then enable the **OPTIS Swatch** app toggle and click **Save**.

*This allows you to fully test the app without affecting your live store.*
{% endhint %}
{% endstep %}

{% step %}

### Configure your Shopify variants

* Make sure your products have variants (e.g. Color, Size) → Click **Configure variants** to open **Variants Display**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-16fd7a7ad181744f53b88e07e541c72258f39f5d%2Fquickstart-configure-variants-button.png?alt=media" alt="Configure variants button opening the Variants Display page"><figcaption></figcaption></figure>

* Here, you can customize how variants are displayed on Product pages and Collection pages - Choose the display type that fits your store design

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-941b5b29cbaafc041063843d5dd02cd5a1c311bb%2Fquickstart-variants-display-types.png?alt=media" alt="Variants Display page with display type options for product and collection pages"><figcaption></figcaption></figure>

👉 **Click here to learn** [**How to change the variant display**](https://docs.optis.me/swatch/variant-display/auto-image-swatch)
{% endstep %}

{% step %}

### Make it yours! (optional)

* Click **Style your variants** to open the **Styling Dashboard**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9f4cb28aabf3af7b2204d3f367ee0ce4c85f3c04%2Fquickstart-style-your-variants-button.png?alt=media" alt="Style your variants button opening the Styling Dashboard"><figcaption></figcaption></figure>

* Customize how variants look on your store, including size, alignment, colors, spacing, hide extra swatches,...

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-e1c526e215d1d511a409501d3243d79fdede7d24%2Fquickstart-styling-dashboard.png?alt=media" alt="Styling Dashboard with size, alignment, color, and spacing options"><figcaption></figcaption></figure>

👉 **Click here to learn** [**How to customize the swatches' look?**](https://docs.optis.me/swatch/styling/styling-overview)
{% endstep %}
{% endstepper %}

You're all set! 🎉\
Continue to the next sections to explore advanced settings and customization options.


# Core features overview

This section explains how OPTIS Color Swatch works with your Shopify products, variants, and theme. Understanding these core concepts will help you configure the app correctly and avoid common setup i

***

## 🔹 [Variant Display (Shopify variants-based)](https://docs.optis.me/swatch/variant-display/auto-image-swatch)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FFUEqFF0B8RsNUhizVDI8%2Fimage.png?alt=media&amp;token=b8c2854c-b265-4186-bf6a-764c06bf3ece" alt=""><figcaption></figcaption></figure>

OPTIS Color Swatch reads your existing **Shopify product variants** (such as Color or Size) and converts them into visual swatches / buttons / dropdown menus

* Works directly with Shopify variants (no new variants are created)
* Allows swatches to be displayed on:
  * Product pages
  * Collection pages

## 🔹 [Product Group (Combine listings)](https://docs.optis.me/swatch/product-groups/show-separate-products-as-variants-with-product-groups)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FKfLO3v3RlPFO4T4FLduf%2Fimage.png?alt=media&amp;token=919c4b20-1eb3-4755-8219-f8293879fc77" alt=""><figcaption></figcaption></figure>

Product Group lets you group multiple products into a single variant-like experience.

* Each product acts as a variant option
* Clicking a grouped option redirects customers to the corresponding product page
* Useful when each color or style is a separate product in Shopify

## 🔹 [Variant Images](https://docs.optis.me/swatch/variant-images/show-images-per-variant)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FWBIysoVi8L1IbMb9wiKt%2Fimage.png?alt=media&amp;token=5e5c4168-9376-4e24-8eda-753c36add401" alt=""><figcaption></figcaption></figure>

Controls how product images are shown based on the selected variant.

* Updates the product gallery when a variant is selected
* Displays only images assigned to the selected variant
* Improves visual clarity and user experience

## 🔹 [Styling](https://docs.optis.me/swatch/styling/styling-overview)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FXdU0ubsolmrcCydGIybY%2Fimage.png?alt=media&amp;token=e2c0096a-2e2a-4682-b1a4-b312f4bae447" alt=""><figcaption></figcaption></figure>

Customizes the appearance of variant displays across your store.

* Adjust size, alignment, colors, spacing, and visibility
* Applies globally to all enabled displays
* Can be updated anytime without affecting product data

## 🔹 [Global Settings](https://docs.optis.me/swatch/global-settings/global-settings-overview)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FUthuCiU18fPVuVBV5o2U%2Fimage.png?alt=media&amp;token=0c7f0fbc-5ef9-4510-beb3-239bcfd4a18e" alt=""><figcaption></figcaption></figure>

Controls global behaviors and advanced appearance settings for your store.

* Customize how [**out-of-stock**](https://docs.optis.me/swatch/global-settings/out-of-stock-display) and [**non-existent**](https://docs.optis.me/swatch/global-settings/non-existent-display) variants are displayed
* Turn on store-wide [**Automatic badges**](https://docs.optis.me/swatch/global-settings/automatic-badges) — Sold out, Low stock, New, or On sale
* Enable or disable **tooltips**
* Add [**custom CSS**](https://docs.optis.me/swatch/global-settings/custom-css) for advanced styling needs


# Auto image swatch

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

✨Demo product: [Auto image swatch](https://optis-color-swatch-variant.myshopify.com/products/auto-image-swatch?_pos=1&_psq=auto&_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-6b2f18b8be5b57d09f1f2115f919e66f7fc4e648%2Fauto-image-swatch-hero.png?alt=media" alt="Auto image swatch shown on a product"><figcaption></figcaption></figure>

### **Function**

**Auto image swatch** turns the **variant images you already set in Shopify** into swatches — automatically, with no manual upload. Each variant value shows its own Shopify image as the selector.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-b2ae5875d30bdc9dec217d1b0ebb78c0db07ce0f%2Fauto-image-swatch-from-variant-images.png?alt=media" alt="Auto image swatches generated from Shopify variant images"><figcaption></figcaption></figure>

### **How it works**

* The app reads the **image assigned to each variant** in Shopify and uses it as the swatch.
* **No manual upload needed** — nothing to configure per value.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FwkG16uVmyhJfzO14WLYe%2Fimage.png?alt=media&amp;token=7053eab1-c57a-4347-99a1-5d0f1ecba9a9" alt=""><figcaption></figcaption></figure>

* When you **change a variant image in Shopify**, the swatch updates after the next **Sync** (use **Sync data** on the Variants display page, or wait for auto-sync).

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FXOEqkpf2UOdNOP4qEXEB%2Fimage.png?alt=media&amp;token=5fb614ea-24f9-4666-a948-5b092bfecf71" alt=""><figcaption></figcaption></figure>

* If a value has **no variant image**, it has nothing to show — use [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch) to set an image or color for it instead.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FfW2V9138HFq387az3RGg%2Fimage.png?alt=media&amp;token=01df6b15-6824-427c-a935-6515b50d90e2" alt=""><figcaption></figcaption></figure>

### **Use when**

* Each variant already has its **own product image** (e.g. Color = Red, Blue, Black).
* You want swatches to **always stay in sync** with your Shopify images.
* You don't want to manage swatch images separately from your product images.

### **Auto image swatch vs. Custom swatch**

<table><thead><tr><th width="344.9765625">Auto image swatch</th><th>Custom swatch</th></tr></thead><tbody><tr><td>Uses the variant images already in Shopify</td><td>You set the image/color for each value by hand</td></tr><tr><td>Zero setup, stays in sync with Shopify</td><td>Supports solid colors, two-color split, and uploaded images</td></tr><tr><td>Needs every variant to have an image</td><td>Best for colors, patterns, textures, or values with no image</td></tr></tbody></table>

***

## How to use Auto image swatch

{% stepper %}
{% step %}

#### Change the display type to Auto image swatch → Click Save

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FutteI49uhBRJEv1plMFs%2Fimage.png?alt=media&amp;token=ab1f1950-5333-434e-9636-9581ce564418" alt=""><figcaption></figcaption></figure>

In **Variants display**, set the option's **Product page display** (and/or **Collection page display**) to **Auto image swatch**.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FHeCTbRP3MstDQHduDG37%2Fimage.png?alt=media&amp;token=f997f99d-6d06-4153-8da8-cfd1ae71ba47" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Make sure each variant has an image in Shopify

Assign an image to every variant value on the Shopify product. Values without an image won't render a swatch.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FuSyy7bTyZSiymSdcimr8%2Fimage.png?alt=media&amp;token=778e20d1-fae0-4b58-85c4-7fd43fcf3e48" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Sync so the app picks up your latest images

If you added or changed variant images, click **Sync data** on the Variants display page so the swatches reflect them.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F9dVBJ9p6JRwhh7Sfk5mm%2Fimage.png?alt=media&amp;token=6d7d7084-93a3-40a1-bba9-ca28b75d5a99" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Want the swatches to show **colors, patterns, or textures** instead of the full product photo — or fill in values that have no image? Use [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch).
{% endhint %}

***

## 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-9ac988ffe661679b70d8bc00abbf87c819801c85%2Fauto-image-swatch-product-page.png?alt=media" alt="Auto image swatch 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-9e41c8f4db162be544662d7fb8752db7c83e3d13%2Fauto-image-swatch-collection-page.png?alt=media" alt="Auto image swatch on the collection page"><figcaption></figcaption></figure>

{% hint style="info" %}
Want to change the **size, shape, spacing, or border** of the swatches? That's handled in [Styling](https://docs.optis.me/swatch/styling/styling-overview).
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FpUZ7yDroDCF6AyZtDwKI%2FScreenshot%20(19).png?alt=media&amp;token=2b6198ab-d728-4633-91aa-5af3b5d33ee9" alt=""><figcaption></figcaption></figure>

### Related

* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch) — set images/colors manually
* [🪄 Auto-assign swatch](https://docs.optis.me/swatch/variant-display/auto-assign-color-swatch) — fill colors in one click
* [Why is my image swatch blurry?](https://docs.optis.me/swatch/frequently-asked-questions/why-is-my-image-swatch-blurry-and-how-can-i-fix-it)


# Custom swatch

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

✨Demo product: [Custom swatch](https://optis-color-swatch-variant.myshopify.com/products/custom-swatch?pr_prod_strat=collection_fallback\&pr_rec_id=a9de6891c\&pr_rec_pid=8274609307785\&pr_ref_pid=8274596233353\&pr_seq=uniform) (password: 1)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FhWVxJabQxusTWj1LWsEZ%2Fimage.png?alt=media&amp;token=84690720-9e44-4df5-a7fc-c41bbc917086" alt=""><figcaption></figcaption></figure>

### **Function**

**Custom swatch** lets you manually decide what each variant value looks like, instead of relying on the product images. For every value you can set a **common** swatch — shared by every product that has that value — as:

* An **uploaded image** — a pattern, texture, fabric close-up, or any picture you choose, or
* A **solid color** entered as a **hex code**, or
* Or a **two-color split** — two hex codes shown side by side in the same swatch (great for values like *Black / White*).

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FDqJNsM3OuVsYwHkLraHT%2Fimage.png?alt=media&amp;token=4f695e2b-de4b-4b43-bc21-29cf7a1f0985" alt=""><figcaption></figcaption></figure>

Each value is independent, so you can mix images and colors within the same option. If a couple of products need a different shade under the same value name (e.g. two products both have a "Pink" variant, but the real color isn't quite the same), you can also override the swatch for just those products — see below.

### **Use when**

* Variants already have images in Shopify **but you don’t want to use those images as swatches**.
* You want swatches to show **patterns, textures, materials, or plain colors** rather than full product photos.
* A value has **no variant image**, so [Auto image swatch](https://docs.optis.me/swatch/variant-display/auto-image-swatch) has nothing to show.
* You need **precise brand colors** that a photo can’t reproduce accurately.

### **Custom swatch vs. Auto image swatch**

<table><thead><tr><th width="363.62890625">Custom swatch</th><th>Auto image swatch</th></tr></thead><tbody><tr><td>You set the image/color for each value by hand</td><td>Uses the variant images already in Shopify</td></tr><tr><td>Supports solid colors, two-color split, and uploaded images</td><td>Shows the product photo only</td></tr><tr><td>Best for colors, patterns, and textures</td><td>Best when variant photos already look good as swatches</td></tr></tbody></table>

***

## How to use Custom swatch

{% stepper %}
{% step %}

#### Change the display type to Custom swatch → Click Save

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FzNYb6825TXSE6gtvVfFt%2FScreenshot%20(14).png?alt=media&amp;token=9ac51d8e-dfed-4804-ab17-b1159f20c984" alt=""><figcaption></figcaption></figure>

In **Variants display**, find the option you want to configure and set its **Product page display** (and/or **Collection page display**) to **Custom swatch**.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FmDw3FIKyY5o8l8mVUPbG%2FScreenshot%20(15).png?alt=media&amp;token=5697fa3b-94c1-4763-bb5a-cdac42269d17" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Open the swatch editor (pencil icon)

Once the display type is **Custom swatch**, a **pencil / edit icon** appears next to it. Click it to open the editor — titled **Custom Swatch:&#x20;*****{option name}*** — which lists every value of that option. Click **"Show N products"** under a value to expand the individual products using it.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-428cc38f8e05adf5700ee767caf4691b284de44f%2Fcustom-swatch-change-display-type.png?alt=media" alt="Changing the display type to Custom swatch"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Assign a swatch to each value — or override it for one product

Each value row, and each product row under it, has the same three ways to set a swatch:

* **Add color (1st color)** — click the first color box and pick a color or paste a **hex code** (e.g. `#FF0000`).
* **Add a 2nd color** — pick a second color to create a **two-color split** swatch. The direction of the split (diagonal, horizontal, vertical) is controlled globally in [Two-color swatch split](https://docs.optis.me/swatch/global-settings/two-color-swatch-split).
* **Upload image** — upload your own picture (pattern, texture, fabric detail, etc.) to use as the swatch.

Set it on the **value row** and it becomes the **common** swatch for every product with that value. Set it on a **product row** instead (after expanding "Show N products") and only that product uses it — the product now overrides the common swatch; enter the same value as the common swatch again, or click **Reset** on that row, to go back to using the common swatch.

The **thumbnail on the left updates live**: it shows the common swatch, or a stacked preview once at least one product has its own override.

{% hint style="info" %}
A value (or a product's override) can be **either a color or an image**, not both. Setting a color clears an uploaded image, and uploading an image clears the colors — the editor switches automatically.
{% endhint %}

{% hint style="warning" %}
Setting a different swatch per product is a **paid-plan feature**. Shops on a legacy free plan, or a free plan past the 72‑hour trial, see the per-product fields locked with an **Upgrade** link — see [Pricing Plans](https://docs.optis.me/swatch/subscription-and-billing/pricing-plans). Product-specific swatches set before being downgraded are kept and reappear once the shop is back on a paid plan.
{% endhint %}

To clear swatches in bulk, tick the rows you want (ticking a value selects its common row **and** every product under it) and click **"Remove swatch"**.
{% endstep %}

{% step %}

#### (Optional) Save time with Auto-assign & Bulk update

At the bottom of the editor you’ll find two helpers:

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FHrD9btJVdnu1WPPlRRU0%2Fimage.png?alt=media&amp;token=adc70419-df9b-4f41-a22f-11aad89b2317" alt=""><figcaption></figcaption></figure>

* **✨ Auto-assign swatch** — fills in a matching **common** color for every value that doesn't have one yet, in one click (from the Color taxonomy metafield, the value name, or the variant image); it never overwrites a product's own override. See [Auto-assign swatch](https://docs.optis.me/swatch/variant-display/auto-assign-color-swatch).
* **Bulk update** — **Import** a `.csv` / `.xlsx` file to set many swatches at once, or **Export** your current values to edit them in a spreadsheet. The file has an `Apply_to` column so each row can target **All products** (the common swatch) or one **Specific product** (an override).

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FcpD8kKyZ2ow4RZjxpQnF%2Fimage.png?alt=media&amp;token=686b0b85-9e5c-4581-8210-89b439b6f6d6" alt=""><figcaption></figcaption></figure>

Use the **Search variant** box at the top to quickly find a value when an option has many of them.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FejeSgobvwMqdlfcSmeVx%2Fimage.png?alt=media&amp;token=2c7e6243-9269-4bc4-a5ec-0ecdddd15fd3" alt=""><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%2FtyIyw4L6D73AZ8n5AyqG%2Fimage.png?alt=media&amp;token=ed73441f-052d-4415-9032-475339646f68" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**A 2nd color needs a 1st color.** If you set only the second color of a value, the editor shows an error and **Save is disabled** until you also set the first color (or clear the second one).
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fqhdphb2PKFl6TpHaAXzL%2Fimage.png?alt=media&amp;token=d99e6bdd-a891-4815-bbaa-d192e7e33829" 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-cbbcb63ad02a19af5caa62b0bc78bdf61f34f960%2Fcustom-swatch-product-page.png?alt=media" alt="Custom swatch 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-b2c137a180532c16dcb7ce0766633cb052c49985%2Fcustom-swatch-collection-page.png?alt=media" alt="Custom swatch on the collection page"><figcaption></figcaption></figure>

{% hint style="info" %}
Want to change the **size, shape, spacing, or border** of the swatches? That’s handled separately in [Styling](https://docs.optis.me/swatch/styling/styling-overview), not in the Custom swatch editor.
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FIjbne3KcEc7mJ2NBm1mc%2Fimage.png?alt=media&amp;token=f7a8d06b-acf2-42f8-9ca8-4f00c6f309e9" alt=""><figcaption></figcaption></figure>

### Related

* [🖼️ Auto image swatch](https://docs.optis.me/swatch/variant-display/auto-image-swatch) — use variant images automatically
* [🪄 Auto-assign swatch](https://docs.optis.me/swatch/variant-display/auto-assign-color-swatch) — fill colors in one click
* [Two-color swatch split](https://docs.optis.me/swatch/global-settings/two-color-swatch-split) — control the split direction


# Swatch card

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

✨Demo product: [Swatch card](https://optis-color-swatch-variant.myshopify.com/products/bucket-hat-1?variant=45188750508169) (password: 1)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-a3d6cf93b24dd8d1c5a5349c166f0f1fb15005f6%2Fswatch-card-hero.png?alt=media" alt="Swatch card shown on a product"><figcaption></figcaption></figure>

### **Function**

Displays each variant as a **polaroid-style card** showing the **swatch (image or color)**, the **option value**, and the **price (optional)** in one layout — so customers see the key details of every variant at a glance.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FbrujhhNFlFDaoonxr57E%2Fimage.png?alt=media&amp;token=b51e70af-5293-4a37-be4f-ef2a96eea8e6" alt=""><figcaption></figcaption></figure>

### **How it works**

* Each value appears inside its own **card**: preview on top, label (and optional price) below.
* The selected card is **visually highlighted**.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fwq8bdXkIm6Cy2qGA2cDp%2Fimage.png?alt=media&amp;token=cc6dd2c2-ac2a-467d-bd97-0be5f9367503" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FPhO4P2I7GenxsaxLqygV%2Fimage.png?alt=media&amp;token=631baeda-6c50-4399-b9cc-4d35c20c7c66" alt=""><figcaption></figcaption></figure>

### **Use when**

* Variants differ in **appearance and price**.
* You want customers to **compare options easily** without clicking back and forth.
* You have room on the product page for a richer, more visual selector.

***

## How to use Swatch card

{% stepper %}
{% step %}

#### Change the display type to Swatch card → Click Save

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FXJd9LWv4tkZpBot3EHZQ%2Fimage.png?alt=media&amp;token=1a321c5c-3045-400b-a51a-6452f3fd1ac7" 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 to pick where the card's swatch comes from:

* [**Auto image swatch**](https://docs.optis.me/swatch/variant-display/auto-image-swatch) → 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-9c3e9ee8644a932c4209bc550f0e679308925421%2Fswatch-card-source-auto-image.png?alt=media" alt="Swatch card using the Auto image swatch source"><figcaption></figcaption></figure>

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

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-840c52daa7213a91ea64309c3692038da4ad0705%2Fswatch-card-source-custom.png?alt=media" alt="Swatch card 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%2FC9pqWN8pAOYi9uGyZjjd%2Fimage.png?alt=media&amp;token=a50f3098-69f8-4d34-a7b5-fee2564559fc" 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).
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FRtaQJQbU8USjYXlZHlvn%2Fimage.png?alt=media&amp;token=d9535b43-2ec2-47e8-be23-fbccb767b3df" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Show price** on the card, along with card **size, spacing, text, and colors**, is configured in [Styling](https://docs.optis.me/swatch/styling/styling-overview) — 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%2FTbREIGR32BFgWm7m8CZ6%2FScreenshot%20(23).png?alt=media&amp;token=99b46e3c-9e24-49e9-b838-98047824793c" 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-9ab25990e2a8ec15958dd6715271f184eb67ff58%2Fswatch-card-product-page.png?alt=media" alt="Swatch card on the product page"><figcaption></figcaption></figure>

### Related

* [💊 Pill swatch](https://docs.optis.me/swatch/variant-display/pill-swatch) — a more compact image + label option
* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch) / [🖼️ Auto image swatch](https://docs.optis.me/swatch/variant-display/auto-image-swatch) — the two sources
* [Styling settings reference](https://docs.optis.me/swatch/styling/styling-settings-reference) — show price, sizing, colors


# 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) or [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch).

<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).

***

## 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) → 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) → 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).
{% 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) — 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) — a larger card layout with the same two sources
* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch) / [🖼️ Auto image swatch](https://docs.optis.me/swatch/variant-display/auto-image-swatch) — the two sources
* [Styling settings reference](https://docs.optis.me/swatch/styling/styling-settings-reference) — show price, thumbnail size, colors


# 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).
{% 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).

<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) — better when an option has many values
* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch) — when values need a color or image
* [Styling settings reference](https://docs.optis.me/swatch/styling/styling-settings-reference) — padding, colors, spacing


# Dropdown

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

✨Demo product: [Dropdown](https://optis-color-swatch-variant.myshopify.com/products/dropdown?_pos=1&_psq=drop&_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-1203c50f6482abb8e3e63fd8663627cdc6df5883%2Fdropdown-hero.png?alt=media" alt="Dropdown variant selector on a product"><figcaption></figcaption></figure>

### **Function**

Displays an option's values inside a **collapsed dropdown**, letting customers choose one value from a list — the most space-saving selector.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fmlp6XO0Haur3goXdNJi4%2Fimage.png?alt=media&amp;token=42b4b431-f5ba-40ff-8300-4968125778e7" alt=""><figcaption></figcaption></figure>

### **How it works**

* Values are hidden inside a **collapsed dropdown** until opened.
* Customers select **one value at a time**; the chosen value shows as the active choice.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FYToTSXAuAVRnL0pMIA84%2Fimage.png?alt=media&amp;token=ae79caaa-a419-4c42-812a-e4093c2aedc2" alt=""><figcaption></figcaption></figure>

* This is a **text-only** selector — no image or color, so there's no swatch editor to set up.

### **Use when**

* An option has **many values** and buttons/swatches would take too much room.
* You want to **save space** on the product or collection page.
* Options are **text-based** and don't need visual comparison.

***

## How to use Dropdown

{% stepper %}
{% step %}

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

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F1JJy22Rcv6TJmxHCCe4D%2Fimage.png?alt=media&amp;token=a8d981f7-f617-44a2-9505-1b0ff31db85a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FXpRj3G3AIzpL78Kju8cU%2FScreenshot%20(6).png?alt=media&amp;token=0fd1f49b-2db1-4329-b4fa-e50eea40551d" 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%2FcPdb4whEQCImIWuodqx4%2FScreenshot%20(8).png?alt=media&amp;token=921c4e57-afe1-4342-a89d-1be31a818a06" alt=""><figcaption></figcaption></figure>

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

***

## 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-d4f74a37214783eb4fb972ddfed0163e1cab20ec%2Fdropdown-product-page.png?alt=media" alt="Dropdown 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-9b07f3aac16d7d07fe27d8f68173c86341c3deda%2Fdropdown-collection-page.png?alt=media" alt="Dropdown variant selector on the collection page"><figcaption></figcaption></figure>

### Related

* [Button](https://docs.optis.me/swatch/variant-display/button) — text buttons when there are only a few values
* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch) — when values need a color or image
* [Styling settings reference](https://docs.optis.me/swatch/styling/styling-settings-reference) — font, padding, colors


# No show

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

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9d0a9893ec637bc822178d0c872ed1f7d2a00521%2Fno-show-keeps-theme-default.png?alt=media" alt="No show option keeping the theme&#x27;s original variant selector"><figcaption></figcaption></figure>

### **Function**

Tells the app to **leave this option alone**. The app doesn't render or configure it, so the variant keeps using your **theme's original selector**.

### **How it works**

* The app **does not render** this option — no swatch, button, or dropdown is added.
* The variant keeps using the **theme's original design and logic**.
* Nothing is configured for this option, so there's no editor or styling to set up.

### **Use when**

* You want to **keep the theme's default variant UI** for a specific option.
* The option is **already handled correctly** by the theme and doesn't need the app.
* You're styling one option with the app but want another (e.g. Size) untouched.

***

## How to use No show

{% stepper %}
{% step %}

#### Change the display type to No show → Click Save

In **Variants display**, set the option's **Product page display** (and/or **Collection page display**) to **No show**.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-b6a0273cc8f4c28a66724905e746fbc13b05e1f9%2Fconfigure-variants-set-no-show.png?alt=media" alt="Setting an option to No show in Variants display"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**No show** and **hiding a single-variant option** are different. To automatically hide options that have only one value, see [Hide single variant](https://docs.optis.me/swatch/global-settings/hide-single-variant).
{% endhint %}

### Related

* [Hide single variant](https://docs.optis.me/swatch/global-settings/hide-single-variant) — auto-hide options with one value
* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch) — when you *do* want the app to style an option


# Auto-assign swatch

### **Function**

Setting a color for every variant value one by one can take a while, especially with options like *Black*, *Dawn*, *Lavender,*… **Auto-assign swatch** does this for you with a single click — it looks at each value and fills in a matching color automatically.

You'll find this button in the **Custom swatch editor**, no matter which display type you're using — **Custom swatch**, **Swatch card**, **Pill swatch**.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-138c7ed6dc9311fc1c9b8ccfbe9a98fc79b3e647%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### **How it picks a color**

The app checks each value against **3 sources**, trying them in order until one works:

1. <mark style="color:$primary;">**Color taxonomy metafield**</mark> — if your product uses Shopify's standardized Color taxonomy, the app reads the exact color defined there. This is the most reliable source, since the color was deliberately set, not guessed.

   <figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-740f711b204fc7ef56e7fbf955b7d7f79e8eac75%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
2. <mark style="color:$primary;">**Value name**</mark> — if there's no taxonomy color, the app tries to recognize a color from the name itself<br>

   <figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-666f551f4121a9813c99bcbbb25b57fe36b7db42%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
3. <mark style="color:$primary;">**Variant image**</mark> — if the name doesn't give a clear answer either, the app looks at the variant's image. If that value already has its own swatch image set in Shopify, the app uses that image directly as the swatch; otherwise it extracts the dominant color from the variant's photo.<br>

   <figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-23bb05812598c0d827f3a7779cd1dfc333d0450a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

If a value can't be matched through any of these, it's simply **left blank** for you to fill in by hand.

### **Use when**

* You have a color option with **many values** and don't want to set them one at a time.
* Some of your products use Shopify's **Color taxonomy**, and you want those colors to carry over automatically instead of re-entering them.
* You just want a quick starting point — you can always fine-tune individual colors afterward.

### **How to use it**

{% stepper %}
{% step %}

#### Open the swatch editor for your color option

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-c47b522a48df4cdc9f41d15059c7f04a2ddf4fe3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click **Auto-assign swatch**

It's the button in the bottom-left corner of the modal. The app goes through every value and fills in a color where it can.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FC7UtutmOmqQgG8K6mX1x%2Fimage.png?alt=media&amp;token=f03f7852-7cac-4676-9bf2-4daf5094ab2b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Check the result and adjust if needed

Any value left blank means the app couldn't confidently detect a color — set it manually using **Add color**. You're also free to change any auto-filled color; it won't be overwritten unless you run Auto-assign again.
{% endstep %}

{% step %}

#### Click **Save**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FS35ku1PSof5w3RxAn3OC%2Fimage.png?alt=media&amp;token=15fb1e00-932d-41af-9115-2684410a30d5" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Note:** If a value **already has a color or image set**, Auto-assign leaves it as is — it never overrides an existing swatch, so it's safe to run anytime without losing your manual work.
{% endhint %}


# Option and value descriptions

✨Demo product: [Option description](https://optis-color-swatch-variant.myshopify.com/products/nordic-dining-table-description-for-option?_pos=1&_psq=desc&_psid=38a503945&_ss=e) (password: 1)

Show extra details about an option or a specific value — pulled straight from a **Shopify metafield** — instead of leaving shoppers to guess what "Merino wool" or a color name means. Configure it from **Configure Variants → Description config**.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FvUWgohwygocNajoZqh64%2Fimage.png?alt=media&amp;token=a4dc8420-2dc4-4ee8-b2c8-fa2f9c0b9962" alt=""><figcaption></figcaption></figure>

## Two levels

<table><thead><tr><th width="160">Level</th><th>Metafield owner</th><th>Use for</th></tr></thead><tbody><tr><td><strong>Option-level</strong></td><td>Product metafield</td><td>A description that applies to the whole option (e.g. a sizing note for "Size")</td></tr><tr><td><strong>Value-level</strong></td><td>Variant metafield</td><td>A description specific to one value (e.g. fabric details for "Merino wool")</td></tr></tbody></table>

For each level, pick the **metafield** to pull the description from, then choose where it displays:

* **Below name**
* **Beside name**
* **Below option**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FYvAR0S8XK5RvY4TW3cE8%2Fimage.png?alt=media&amp;token=917940ce-59f8-4b6a-9e68-ee6949e8e645" alt=""><figcaption></figcaption></figure>

* **Tooltip** (on hover)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F6wct8EvrCPnWDWlLaAHX%2FScreenshot%202026-09-27%20at%2007.01.30.png?alt=media&amp;token=2f3479b7-bcd5-4361-a27a-194677c35bdd" alt=""><figcaption></figcaption></figure>

* **Popup** (on click)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FezDD3K8O3fsCZhJBTb4u%2Fimage.png?alt=media&amp;token=b3379d74-497d-4a14-8dcc-964fe082f9bf" alt=""><figcaption></figcaption></figure>

## Supported metafield content

The description renders differently depending on the metafield's type:

<table><thead><tr><th width="140">Metafield type</th><th>How it renders</th></tr></thead><tbody><tr><td>Plain text</td><td>Shown as-is</td></tr><tr><td>Color (hex)</td><td>Rendered as a color swatch</td></tr><tr><td>Image</td><td>Shown as an image</td></tr><tr><td>Video</td><td>Shown as an inline video player</td></tr><tr><td>Measurement</td><td>Formatted as "&#x3C;value> &#x3C;unit>" (e.g. "42 cm")</td></tr><tr><td>Rating</td><td>Formatted as "&#x3C;value>/&#x3C;scale>" (e.g. "4/5")</td></tr><tr><td>Money</td><td>Formatted as "&#x3C;amount> &#x3C;currency>" (e.g. "12 USD")</td></tr></tbody></table>

{% hint style="warning" %}
The app only **picks** an existing metafield — it can't create one. You must create the metafield definition (and fill in its value on each product/variant) in **Shopify admin** first.
{% endhint %}

## How to set it up

### Step 1: Create the metafield in Shopify admin

Create one definition for each level you plan to use — they live under different owner types, so set them up separately.

{% stepper %}
{% step %}

#### Go to Shopify admin → **Settings → Custom data**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9e69484c86ae84d00b64dc66d4632920332f6709%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Pick the owner type for the level you're setting up

* **Option-level** description → click **Products** → **Add definition**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-c1beb240f17f5438dc38b8dbf24b03c85dad3b38%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Value-level** description → click **Variants** → **Add definition**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9370686fae1ebe732bb931369f36eb3479a512a4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Name the definition and choose its type

Give it a clear **Name** (this is what you'll see in the app's picker, shown as `Name (namespace.key)`), then pick a **Content type**. Any type works — the display type just changes how it renders on the storefront:

* **Single line text** / **Multi-line text** → shown as plain text
* **File** (image) → shown as an image
* **File** (video) → shown as an inline video player
* **Dimension** → formatted as "value unit" (e.g. "42 cm")
* **Rating** → formatted as "value/scale" (e.g. "4/5")
* **Money** → formatted as "amount currency" (e.g. "12 USD")

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-1248948e53d25e9994fed8a6437a84a201583077%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Save the definition

{% endstep %}

{% step %}

#### Fill in the value on each product

**Option-level**

1. On the Product page, scroll down to the Product metafields section.
2. Select the metafield created for Option description.
3. Enter the description for each option on that product. Repeat these steps for every product where you want to show option descriptions.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-7bbbceff63f3bce1b44c30f6ded42e81403f1beb%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**Value-level**

1. Open the product and click the variant you want to add a description for.
2. Scroll down to the Variant metafields section.
3. Select the Option Value Description metafield and enter the description for that variant value. Repeat these steps for each variant that needs a description.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-1fd193057ef091344d00dd008ee29a3cb9490c04%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Step 2: Turn it on in the app

{% stepper %}
{% step %}

#### Go to Variant display → open **Description config** for an option

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-f235466129da001d115d961993351d1693ab1d61%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Turn on Option-level and/or Value-level descriptions

Pick the metafield you created — the **Option-level** dropdown lists your Product definitions, the **Value-level** dropdown lists your Variant (product variant) definitions.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-acf71630c78762569b8322ef93164c79bd6fe388%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Choose the display type

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F1H9B8uT96ffElxMKSAqi%2Fimage.png?alt=media&amp;token=4c98caf9-3c56-4c05-a24c-6d30435d8ae7" alt=""><figcaption></figcaption></figure>

Below name, beside name, below option, tooltip, or popup.
{% endstep %}

{% step %}

#### Click **Save**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fhw2ZpAaBgt014OrvlLsG%2Fimage.png?alt=media&amp;token=6d0c0c02-31ea-4dc4-9637-60d05aad70f8" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Added a new metafield in Shopify but don't see it in the dropdown? Refresh the Description config modal — it only lists definitions that already exist at the time it loads.
{% endhint %}


# Common questions

Answers to common questions about displaying variant swatches, buttons, and dropdowns on your product and collection pages.


# Can I show swatch on collection page?

Yes.

OPTIS Color Swatch allows you to display product variant options (like swatches, buttons, or dropdowns) directly on your **collection pages**, so customers can select a variant without opening the product page.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9cafbb71553103573d6e1aa1e252dbd6fe9d6e51%2Fcollection-page-swatches.png?alt=media" alt="Variant swatches shown on a collection page"><figcaption></figcaption></figure>

## **To enable swatches on the collection page:** <a href="#id-3-to-enable-swatches-on-the-collection-page" id="id-3-to-enable-swatches-on-the-collection-page"></a>

{% stepper %}
{% step %}

### Go to Variants display

In **OPTIS Color Swatch**, go to **Variants display**.
{% endstep %}

{% step %}

### Find the option you want to show

Find the row of the option you want to show on collection pages (e.g., Color, Size). You can use the **Search by option or product name** box to find it quickly.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FOpw4psgW9p3kd2HhYIhS%2FScreenshot%20(12).png?alt=media&amp;token=d1965c18-7acd-4bb0-a5b9-74c1b795dc9c" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Choose a display type in Collection page display

In the **Collection page display** column, open the dropdown and choose how the option should look on collection pages:

* [**Auto image swatch**](https://docs.optis.me/swatch/variant-display/auto-image-swatch)
* [**Custom swatch**](https://docs.optis.me/swatch/variant-display/custom-swatch)
* [**Button**](https://docs.optis.me/swatch/variant-display/button)
* [**Button without border**](https://docs.optis.me/swatch/variant-display/button#button-without-border) (premium)
* [**Dropdown**](https://docs.optis.me/swatch/variant-display/dropdown)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fhb7mo2fhn0K06KyVpAJj%2FScreenshot%20(13).png?alt=media&amp;token=dd88463d-1d48-4fef-a4dd-bb927d261898" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### (Optional) Set up Custom swatch values (pencil icon)

If you choose **Custom swatch**, click the **pencil icon** next to the dropdown to set a color or image for each value. See [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch) for details.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FAD865X0HrP0FizYWqdi5%2FScreenshot%20(53).png?alt=media&amp;token=f8633c9e-87d1-475f-bac4-97fe7a061d22" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click Save to apply changes

Click **Save** in the **Unsaved changes** bar at the top of the page.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F8UDDECHHdSPwJs6i9M3Y%2FScreenshot%20(14).png?alt=media&amp;token=376e94ae-b2d4-4563-b03b-e8542fc1ce20" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Product page display** and **Collection page display** are set separately, so an option can look different on each page. [Swatch card](https://docs.optis.me/swatch/variant-display/swatch-card) and [Pill swatch](https://docs.optis.me/swatch/variant-display/pill-swatch) are available on the product page only, so they don't appear in the Collection page display list.
{% endhint %}

## **Note:** <a href="#id-3-note" id="id-3-note"></a>

* To stop the app from showing an option on collection pages, set its **Collection page display** to [**No show**](https://docs.optis.me/swatch/variant-display/no-show).
* To change the size, shape, or spacing of swatches on collection pages, go to [Styling](https://docs.optis.me/swatch/styling/styling-overview) and switch to the **Collection Page** tab.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FLwe1TaZaUX5gQDg5L89d%2FScreenshot%20(16).png?alt=media&amp;token=0ac8de04-528a-46e8-98d1-c5427c9976e0" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FNUVYGR3GPQM8ixB0K9Xk%2FScreenshot%20(18).png?alt=media&amp;token=68d5ddae-1c82-4df6-91cc-6a8ffab82a79" alt=""><figcaption></figcaption></figure>

* The feature might not work with custom or heavily customized themes out of the box.
* If your theme isn’t supported yet, you can contact our support team, we’ll help with manual setup or theme integration.


# Why doesn’t the product image change when I click a variant?

Our app works **based on Shopify’s native variant configuration**. For the variant image to change correctly, your theme’s **variant picker must be enabled**.

#### How to check and enable it:

{% stepper %}
{% step %}
**Go to Online Store → Themes → Edit theme**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-39b129d2e0b294a04ceb5ee8fe4531bd4f492658%2Ftheme-editor-edit-theme.png?alt=media" alt="Online Store Themes section with the Edit theme button"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Open the Product template**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-365183a222c696cb36a0c1f8a48fd4757681c823%2Ftheme-editor-product-template.png?alt=media" alt="Product template selected in the theme editor"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In the **Product information** section:

* Add the **theme’s Variant Picker**
* Add the **OPTIS app block** as well

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-e32f8e858e41b57e55c2d21b444dbe0534ad2d6b%2Ftheme-editor-add-optis-app-block.png?alt=media" alt="Adding the OPTIS app block to the product template"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

👉 **Important notes**:

* OPTIS **restyles and enhances Shopify variants** - it does **not** create a separate variant system.
* The theme’s variant picker **must remain enabled** for image switching to work properly.
* If you see **both the theme variants and OPTIS swatches showing at the same time**, this is usually a theme conflict. In that case, please **contact our support team** and we’ll help resolve it.

After enabling the variant picker, kindly double-check the product page.\
If the issue still persists, feel free to reach out - we’re happy to assist further.


# Why does the cart add the default variant instead of the selected one?

This usually happens when the **theme’s variant picker is not properly enabled or connected**.

Our app works **on top of Shopify’s native variant configuration**, not independently. This means the theme’s variant picker must be active so Shopify knows which variant is currently selected.

**How to fix this:**

{% stepper %}
{% step %}
**Go to Online Store → Themes → Edit theme**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-39b129d2e0b294a04ceb5ee8fe4531bd4f492658%2Ftheme-editor-edit-theme.png?alt=media" alt="Online Store Themes section with the Edit theme button"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Open the Product template**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-365183a222c696cb36a0c1f8a48fd4757681c823%2Ftheme-editor-product-template.png?alt=media" alt="Product template selected in the theme editor"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In the **Product information** section:

* Add the **theme’s Variant Picker**
* Add the **OPTIS app block** as well

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-e32f8e858e41b57e55c2d21b444dbe0534ad2d6b%2Ftheme-editor-add-optis-app-block.png?alt=media" alt="Adding the OPTIS app block to the product template"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Once the variant picker is enabled, the selected variant will:

* Stay in sync when customers change variants
* Be correctly added to cart instead of reverting to the default variant

👉 **Important notes**:

* OPTIS **restyles and enhances Shopify variants** - it does **not** create a separate variant system.
* The theme’s variant picker **must remain enabled** for image switching to work properly.
* If you see **both the theme variants and OPTIS swatches showing at the same time**, this is usually a theme conflict. In that case, please **contact our support team** and we’ll help resolve it.

After enabling the variant picker, kindly double-check the product page. If the issue still persists, feel free to reach out - we’re happy to assist further.


# Why do I briefly see the initial variant before the swatches load?

This behavior happens because **theme elements render first**, and then OPTIS loads and applies its configuration afterward. As a result, the initial Shopify variant may briefly appear before OPTIS swatches are displayed.

#### Can this be removed?

Yes - **we can hide the initial variant visually** to create a cleaner loading experience.

⚠️ **Please note**:

* You **cannot remove the theme’s variant picker completely**, because it is required for OPTIS to work correctly.
* We only remove the **visual display**, not the underlying functionality.

💬 If you’d like to remove the initial variant display, please **contact our support team**, and we’ll help you set it up properly.


# Can I style only some variants and keep others in the theme’s original style?

Yes.\
You can control this per variant using the **Display Type** setting.

* For variants you want OPTIS to restyle, select the appropriate display type (Swatch, Button, Dropdown, etc.).
* For variants you don’t want the app to affect, set them to **No Show -** Variants set to **No Show** will keep their **original theme design** and won’t be restyled by the app.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-b6a0273cc8f4c28a66724905e746fbc13b05e1f9%2Fconfigure-variants-set-no-show.png?alt=media" alt="Setting selected variants to No Show in Configure variants"><figcaption></figcaption></figure>

⚠️**Important note:**\
Because each theme handles variants differently, this setup may sometimes cause conflicts. In some cases, you may see:

* The variant set to **No Show** being hidden completely from the product page
* The variant still appearing with OPTIS styling, even though it’s set to No Show

If anything doesn’t work as expected on your store, please contact our support team. We’ll help you troubleshoot and adjust the setup for your theme 😊


# Show Separate Products as Variants with Product Groups

### **📌 What is Product Groups?** <a href="#id-2-what-is-product-groups" id="id-2-what-is-product-groups"></a>

* Product Groups let you **combine multiple separate products into 1 product page (PDP)**.
* Each product in the group will **appear as a variant option**. When customers select that option, the PDP will **redirect to the correct product page** with its own images, price, and details.

**Example:** You sell three separate products: a **blue shirt**, a **red shirt**, and a **navy shirt**. With Product Groups, they can all appear on **one PDP**. Shoppers choose *Blue / Red / Navy* like variant options, and the page switches to the correct product.

**View demo here:** [Link](https://optis-color-swatch-variant.myshopify.com/pages/product-groups)

### **🎯 Why use Product Groups?** <a href="#id-2-why-use-product-groups" id="id-2-why-use-product-groups"></a>

* **Cleaner storefront**: Show related products together instead of splitting them into many pages.
* **Better shopping experience**: Customers can switch colors/styles without leaving the PDP.
* **Accurate details**: Each product still keeps its own price, SKU, and options.

### **⚙️ How to set up a Product Group** <a href="#id-2-how-to-set-up-a-product-group" id="id-2-how-to-set-up-a-product-group"></a>

1. Go to **Product groups**. Click **Add group**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-15b28802de0b2ae9140fdf6804023979c46e5c56%2Fproduct-group-add-group.png?alt=media" alt="Add group button on the Product groups page"><figcaption></figcaption></figure>

2. **Enter a Group Name** (e.g., *Dresses group*).

* The Group Name is only used internally to help you organize and identify your groups.
* It will **not be shown on the storefront**.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-becdbefc1298e3488bfa029bf85753b4258cbd58%2Fproduct-group-internal-name.png?alt=media" alt="Entering the internal group name that is not shown on the storefront"><figcaption></figcaption></figure>

3. **Enter an Option Name** (e.g., *Choose Dress Style*).

* This is the name that customers will see on the storefront.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-1ef2fe04a3fc9245f1302ad41713804998fde40d%2Fproduct-group-option-name.png?alt=media" alt="Entering the option name customers see on the storefront"><figcaption></figcaption></figure>

4. **Choose a Display Style** for how the option will appear (e.g., buttons, swatches) on Product page and Collection page.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-a59e042b407b706740575a060de0b4058f130075%2Fproduct-group-display-style.png?alt=media" alt="Choosing a display style for the product group on product and collection pages"><figcaption></figcaption></figure>

5. **Add products to the group**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-d911625fe306ed86e71277b15d36d65ba4be8eb6%2Fproduct-group-add-products.png?alt=media" alt="Adding products to the product group"><figcaption></figcaption></figure>

6. Enter variant value (Optional)
7. Click **Save** to finish.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-084ddd77580151c936b1e5b356200650793b4ac0%2Fproduct-group-save.png?alt=media" alt="Saving the completed product group"><figcaption></figcaption></figure>

### See also

* [Product Group sub-categories](https://docs.optis.me/swatch/product-groups/product-group-sub-categories) — split a large group into named buckets.
* [Bulk create Product Groups](https://docs.optis.me/swatch/product-groups/bulk-create-product-groups) — create many groups at once from a name pattern, tag, or metafield.
* [Export Product Groups to CSV](https://docs.optis.me/swatch/product-groups/export-product-groups-to-csv) — download every group as a spreadsheet.

{% hint style="info" %}
The search box on the Product Groups list also matches by **product name**, not just the group name.
{% endhint %}




---

[Next Page](https://docs.optis.me/llms-full.txt/1)

