# Getting Started

## Getting Started with Globo Product Options​

Welcome to **Globo Product Options**, the ultimate solution for enhancing your Shopify store with unlimited, customizable product options. Whether you're selling personalized items, offering add-ons, or simply need more flexibility beyond Shopify's default variant limits, Globo Product Options empowers you to tailor your products to your customers' unique needs.​ 😊

***

### 🔧 Key Features

* **Unlimited Custom Options**: Overcome Shopify’s 3-option, 100-variant limit by adding unlimited product options and variants.
* **Diverse Option Types**: Incorporate various input types such as text fields, dropdowns, checkboxes, radio buttons, color swatches, image uploads, date pickers, and more.
* **Conditional Logic**: Display or hide options based on previous selections to create a dynamic and user-friendly shopping experience.
* **Add-on Products**: Offer additional products or services as add-ons, complete with separate pricing and inventory tracking.
* **Multi-language Support**: Translate option values to cater to a global customer base.
* **Import/Export Option Sets**: Easily manage your options by importing or exporting them via CSV files.​

***

### 🚀 Getting Started

#### 1. Install the App

Begin by installing the **Globo Product Options** app from the Shopify App Store

#### 2. Create an Option Set

Navigate to the app dashboard and click on **Option Sets**. Here, you can create a new set of options that will be applied to your products.

#### 3. Add Option Elements

Within your option set, add various option elements such as text fields, dropdowns, or image uploads. Customize each element to fit your product's needs.​

#### 4. Apply Option Set to Products

Assign your created option set to specific products or collections. This ensures that the options appear only where relevant.

#### 5. Configure Conditional Logic (Optional)

Set up rules to show or hide certain options based on customer selections, creating a streamlined and intuitive shopping experience

#### 6. Manage Add-on Products (Optional)

Attach additional products or services as add-ons to your main products. This is perfect for offering gift wrapping, extended warranties, or related accessories.​

***

### 🛠️ Additional Resources

* **User Guide**: Detailed instructions and tutorials can be found in the <https://docs.globo.io/>
* **Support**: If you encounter any issues or have questions, reach out to our support team at <Contact@globosoftware.net>

***

Enhance your Shopify store today with Globo Product Options and provide your customers with a personalized and flexible shopping experience.


# Set Up Product Options

Our Product Options app supports a variety of option types to meet your specific needs.

**For the detailed setup, you can refer to the instruction video here:** [**How to get unlimited variants options in Shopify with Globo Product Options**](https://youtu.be/ChC37ngqLM8?si=qXUsz68YoKuNNmNQ)

<figure><img src="https://youtu.be/Q8EwrbBIs98?si=yJ7HPWaTIyRiMLzi" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

<figure><img src="/files/BK1kePU0oNRfNQ9Bosa5" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Open the "**Build Option"** tab and click **“Add Option.”**
{% endstep %}

{% step %}
From the list, **choose the element** you'd like to add

👉 *Example: Select “Text Area” to collect customer input.*

<figure><img src="/files/F0xAqUVRW2qdKbGtRbv9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Configure each option** based on your preferences.

*(See related guide: Options Configuration)*

<figure><img src="/files/gztv3xqi3qGq0k0AEMcM" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Select the products** you want to apply this option set to

* Manually
* Automate
* All product

<figure><img src="/files/aigJZIiE6Guu0w2iwaft" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Save** to apply your changes.
{% endstep %}
{% endstepper %}

***

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Create Option Set Using Templates

## <mark style="color:blue;">Steps to Manage</mark>

{% stepper %}
{% step %}
**From the app’s left navigation**, click on **Option Sets**.
{% endstep %}

{% step %}
Click the **“Create Option Set”** button.

<figure><img src="/files/uC7wCCRBbls03jB1cWzt" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Add Option** -> Select **Option Template**. \
*Select the Pre-designed Templates / Personalizerd Templates / or Custom Templates*

<figure><img src="/files/6x8SnXwJDksAF9ceSYGw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PBNJdhZMNVYjYQUdBWWF" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Customize labels, required fields, default values, and add-on prices.

<figure><img src="/files/nQ6rzBUMHAOQHfvJ0Xdn" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Select products to apply&#x20;

<figure><img src="/files/tBLfMEoqVZldmZ11fG38" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Save and Preview
{% endstep %}
{% endstepper %}

***

#### <mark style="color:orange;">⚠️</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Note:**</mark>

<mark style="color:orange;">Some templates include features that are only available on the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Paid plan**</mark><mark style="color:orange;">. If you are on the Free plan, these options may</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**not display properly on your storefront**</mark><mark style="color:orange;">.</mark>\ <mark style="color:orange;">To ensure full functionality, please consider</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**upgrading your plan**</mark><mark style="color:orange;">.</mark>

<mark style="color:orange;">Let me know if you want help identifying which templates or elements are premium!</mark>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Apply Option Sets to Products

You can apply an option set to your products in **three different ways**: manually, by conditions, or to all products.

***

{% stepper %}
{% step %}
From the app’s top navigation, go to **Option Sets**.
{% endstep %}

{% step %}
Click the **Assign Products** tab.

<figure><img src="/files/skebHs9I7VEZGNPM9bn9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Selection **Products** you want to apply the options:

#### **✅ Manually**

* Select specific products to apply this option set.
* To remove a product, simply untick it.

<figure><img src="/files/NESQfvYFFrqYEO5eoMEz" alt=""><figcaption></figcaption></figure>

#### **⚙️ Automate Rules**

* Apply based on product conditions such as:
  * Product Title
  * Product Type
  * Product Vendor
  * Product Tag
  * Product Price
* Choose the condition logic (e.g., equals, contains, greater than).

<figure><img src="/files/DbIq1PPnxz9zuxEHEa1N" alt=""><figcaption></figcaption></figure>

#### **🛍️ All Products**

* Apply the option set to **every product** in your store.

<figure><img src="/files/6xQhcd3SSx1KRhTCQXUT" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Save** to apply.
{% endstep %}
{% endstepper %}

***

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Apply Option Sets to Customers

By default, all customers can see option sets. However, you can customize visibility for specific individuals or groups by following the steps below:

***

{% stepper %}
{% step %}
From the app’s top navigation, go to **Option Sets**.
{% endstep %}

{% step %}
Click the **Customers** tab.

<figure><img src="/files/zp4R7GsvDhMvCSKL87JK" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Selection **Customer** you want to apply the options:

#### **🔘 Manually Selection**

* Select specific customers to give access to the option set.
* To remove access, simply untick them.

<figure><img src="/files/WPL1FDtNlTrYJzaEueMI" alt=""><figcaption></figcaption></figure>

#### **⚙️ Automate Rules**

* Apply visibility based on customer conditions such as:
  * Customer Tags
  * Customer Names
  * Customer Email
  * Logged-in Customers
  * Guest (Non - Logged-in Customers)&#x20;

<figure><img src="/files/uthfSfABFhf1freB2FuI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/nLl5NslQjqrnRF9AKV3o" alt=""><figcaption></figcaption></figure>

#### **🛍️ Everyone**

* Allow all customers to see the option set.

<figure><img src="/files/V5ztUHrHdzEuOmolYE7z" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Apply Option Sets to Countries

You can control where your option sets appear based on your customers’ country. This is helpful if certain customizations are only relevant to specific regions.

***

{% stepper %}
{% step %}
From the app’s top navigation, go to **Option Sets**.
{% endstep %}

{% step %}
Click the **Country** tab.

<figure><img src="/files/PgmCrcCvM2sBFl3GnoMx" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Choose the **“Include”/ “Exclude”** option.

Select the countries where you want this option set to be shown.

<figure><img src="/files/XATf6zZHo7YdOszksB9k" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Save** to apply changes.

{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# How to Delete an Option Set

{% stepper %}
{% step %}
From the app’s top navigation, go to **Option Sets**.

<figure><img src="/files/jWudy4Mm9TH9nGABpV7L" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Tick the checkbox next to the option set(s) you want to delete.
{% endstep %}

{% step %}
Click **Delete selected option set(s)**.

<figure><img src="/files/hJHhSkM1WOgszhAE4GUi" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Confirm by clicking the **Delete** button.

<mark style="color:orange;">⚠️</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Note:**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">Deleted option sets cannot be recovered. Be sure before you confirm!</mark>
{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Duplicate an Option Set

{% stepper %}
{% step %}
From the app’s top navigation, go to **Option Sets.**
{% endstep %}

{% step %}
Tick the checkbox next to the option set(s) you want to duplicate.
{% endstep %}

{% step %}
Click **Duplicate Option Set**

<figure><img src="/files/HdDTucuJ8U2LNQNjwEgu" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Import & Export Option Sets

Running multiple Shopify stores? No need to recreate option sets from scratch. Globo makes it easy to **import/export option sets** via CSV.

## <mark style="color:blue;">Export Option Set</mark>

{% stepper %}
{% step %}
Go to **Option Sets** in the left menu
{% endstep %}

{% step %}
Select the sets you want to export.
{% endstep %}

{% step %}
Click the **Export Option sets** button.

<figure><img src="/files/f2WT5ukatwiZ1ffXh0gG" alt=""><figcaption></figcaption></figure>

A CSV file will be downloaded to your device — save it for reuse.
{% endstep %}
{% endstepper %}

## <mark style="color:blue;">Import Option Sets</mark>

{% stepper %}
{% step %}
Go to **Option Sets**.
{% endstep %}

{% step %}
Click **Import Option Sets**.

<figure><img src="/files/npEpK5aE9EkVbMUXElyz" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Upload a properly formatted CSV file [(UTF-8 encoding required)](https://www.w3schools.com/charsets/ref_html_utf8.asp).
{% endstep %}

{% step %}
Click **Upload and Continue** — and your sets will appear!

<figure><img src="/files/1iAz23jbSEMCSv4cVRAp" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 🧠 CSV Format Overview

Here are some important columns in your CSV file:

| Column            | Description                                       |
| ----------------- | ------------------------------------------------- |
| **option\_id**    | Unique ID for each option (e.g., `text-1`)        |
| **option\_type**  | Type of input (text, select, radio, file, etc.)   |
| **option\_label** | Label shown on the product page                   |
| **option\_name**  | Internal name shown in cart/checkout              |
| **required**      | Yes / No                                          |
| **option\_value** | Option values (for select, checkbox, etc.)        |
| **addon**         | Add-on price (number only, no currency symbols)   |
| **products**      | Assign to products manually by ID or set to `all` |

***

### 🔹 Additional Tips

* Make sure your CSV files use **UTF-8** encoding.
* For color swatches, use a hex code (`#FF0000`). For image swatches, use an image URL.
* Paragraph options can be used to add explanatory text blocks between options.

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Key Terminology Simplified


# Name on Product page

The option label is the text customers see when choosing an option in your online store.

{% stepper %}
{% step %}
In the Option Set editor, find the Name on product page.
{% endstep %}

{% step %}
Enter a clear and descriptive name so customers understand the choice they are making.

***Examples:***

* **Size** — if you create a custom option for product sizes using the **Buttons** option type.
* **What will you use your glasses for?** — if you want to ask customers about their intended use.
* **Enter your custom engraving text** — if you offer engraving services.

<figure><img src="/files/dPYvOJKxUtwpnxNg5rW0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Save the changes

{% endstep %}
{% endstepper %}


# Name on Cart Page

The **Option Name** appears on the **shopping cart**, **checkout**, and **order** pages.

* In most cases, the Name on Product page and Cart page can be the same.
* This also serves an **internal purpose** — helping the system distinguish between different options.

**Important:**

* Each Option Name on cart page within the same option set **must be unique**.
* You cannot have two options with identical names in one option set.

💡 Tip: Use clear and consistent names to avoid confusion in orders and reports.

<figure><img src="/files/1BLUZh7NcN0dCVzeWagD" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wmmzpBhMWzuM19MPVnVC" alt=""><figcaption></figcaption></figure>


# Option Value

Some options aren’t complete without **Option Values** — these are the specific choices your customers will see and select.

**Think of it like a menu:**

* The **Option** is the menu section (e.g., *Size*).
* The **Option Values** are the individual items in that section (e.g., *Small, Medium, Large*).

**Example:**\
If you create a **Size** option and choose **Buttons** or **Dropdown**, you could set values like:

* **S**&#x20;
* **M**
* **L**&#x20;

<figure><img src="/files/iRK5fckLmxWzkPouAgjw" alt=""><figcaption></figcaption></figure>

**Why it matters:**\
Option Values turn a generic option into something useful and clickable for your customers — guiding them toward the perfect choice.


# Help Text

**Help Text** is like a friendly assistant right on your product page — giving customers extra guidance about an option.\
It appears **just below the option** and can explain its purpose, give tips, or outline any requirements.

**Example:**\
If you offer **engraved jewelry**, your Help Text might say:

> *"Engraving is limited to 20 characters, including spaces."*

<figure><img src="/files/7pls0eTq29nZSYO86n9h" alt=""><figcaption></figcaption></figure>

This can also be set for each option value:&#x20;

<figure><img src="/files/TnRtKAITqVKpgAKz7sb8" alt=""><figcaption></figcaption></figure>

**Why it matters:**

* Prevents confusion and errors.
* Ensures customers know exactly what’s expected.
* Helps them make the right choice the first time.

💡 **Pro tip:** Keep your Help Text short, clear, and customer-friendly — too much detail can overwhelm shoppers.


# Placeholder

**Placeholder text** is like a little whisper inside your input box — giving customers a quick hint about what to type.\
It shows **before** the customer enters anything, and disappears as soon as they start typing.

**Example:**\
If you have a **text box** for custom printing on a tote bag, your placeholder could be:

> *"Your name"* or *"Enter your text"*

<figure><img src="/files/CLoZUnXqD5dEU57cftCx" alt=""><figcaption></figcaption></figure>

**Why it’s helpful:**

* Gives a clear idea of what’s expected.
* Shows the correct format or style of the input.
* Reduces mistakes and follow-up questions.

💡 **Pro tip:** Keep placeholders short and specific — think of them as an example, not an essay.


# Set up Required filed

## <mark style="color:blue;">Make an Option Required</mark>&#x20;

You can set any option field as **required**, which means customers must fill it in before submitting the form.

{% stepper %}
{% step %}
Go to your **Option Set**.
{% endstep %}

{% step %}
Click on the **element** you want to make required.
{% endstep %}

{% step %}
In the **Required** section, tick the checkbox to enable it.

Untick the checkbox if you want to make the field optional.

***📝 Customers won't be able to proceed without completing required fields.***&#x20;

<figure><img src="/files/LrRRvpi2mWGqwXa94vwY" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Click **Save** to apply the changes.
{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Hide Element Label

Sometimes, you may want to hide the label for certain elements in your option set, whether for a cleaner design or for specific use cases where the label isn’t necessary.&#x20;

####

{% stepper %}
{% step %}
Go to your **Option Set**.
{% endstep %}

{% step %}
Select the **option set** where you want to hide the element label..
{% endstep %}

{% step %}
Check or toggle **Hide Label** to hide the label for that element on the product page.

<figure><img src="/files/Tb2tp1xrILeZQs0bGFuD" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
**Click Save** to apply the changes.

{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Input Type options


# Text and Textarea

#### 📝 Text vs. Textarea: What's the Difference?

Both **Text** and **Textarea** fields serve similar purposes — allowing users to input custom content. However, the **Textarea** is designed for **larger inputs**, offering **more space** and **greater flexibility** in layout.

***

<figure><img src="/files/bROzeNszI8B8yyhazUWD" alt=""><figcaption></figcaption></figure>

#### ⚙️ Basic Settings Available for Both Fields

You can customize the following features for both **Text** and **Textarea** elements:

* **Name on Product page/ Cart page** – Change the display name shown to customers.
* **Required Field** – Make the field mandatory before form submission.
* **Add-on Price** – Add an extra cost when a customer fills out this field.
* **Min/Max Characters** – Set minimum and/or maximum allowed characters.
* **Placeholder/Help Text** – Display guidance text inside the field before entry.
* **Default Value** – Pre-fill the field with a default value.
* **Character Count** – Show a live character counter to users.
* **Conditional Logic** – Show/hide this field based on other option selections.

<figure><img src="/files/Wjnejc1o5evzVYYs925o" alt=""><figcaption></figcaption></figure>

#### ⚙️ Advanced settings:&#x20;

In this section, you can configure several advanced settings for your product option elements:

1. **Add-on Advanced Function**
   * This allows you to customize how add-on products behave.
   * [Learn more about the add-on advanced function here.](/options/add-on-feature/advanced-add-on-function)
2. **Allow Value:** Define what kind of input customers are allowed to enter.

* **Option: Default :** Customers can enter **any value** freely without restrictions.

<figure><img src="/files/wmD8SNo24qmBCbOj0nGW" alt=""><figcaption></figcaption></figure>

* **Letter**: Only letters are allowed (A–Z, a–z)

<figure><img src="/files/Orrp7z7t8KA24vUv3tIV" alt=""><figcaption></figcaption></figure>

* **Letter and Number**: Only letters and numbers are allowed

<figure><img src="/files/qD97SBOIoeTfZuV9Vdz6" alt=""><figcaption></figcaption></figure>

3. **Text transform**

Define how the entered text will be displayed:

* **None**: Keep the text as entered.
* **Always Uppercase**: Convert all letters to uppercase.
* **Always Lowercase**: Convert all letters to lowercase.

**4. Helptext Position**

Choose where to display the help text for the option element:

* **Below Option Label**
* **Below Option Element**
* **Above Option Element**
* **Tooltip**

<figure><img src="/files/XKAICOHmK4UHChSz9q8R" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/jFzYGvwxpBX3ND0qNmzJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/MNIwDojMqkK7tqyKZBuU" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/RR5OSE0UxrMf2TL4o8gq" alt=""><figcaption></figcaption></figure>

4. **Sufix/Prefix**

You can configure a **prefix** or **suffix** to display inside the input field, helping guide the customer’s entry or add context to their input.

<figure><img src="/files/tzCvmvQk4WlYddQFXgRW" alt=""><figcaption></figcaption></figure>

5. **HTML class**&#x20;

You can assign a custom HTML class to an element to control its styling or behavior using CSS or JavaScript.

6. **Column width**

You can **adjust the width** of each form field by setting its **column width**—this helps in creating a more compact, responsive, and visually appealing form layout.

<figure><img src="/files/sgoEIusrn2uwt8ENxjzx" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Number and Phone field

These two input types—**Number** and **Phone**—allow customers to enter numeric values, but they are slightly different in how they are displayed and validated.

<figure><img src="/files/rBVwG6pPIVs7DwhKE7eJ" alt=""><figcaption></figcaption></figure>

**📌 Number Field:**

* Used for any numeric input (e.g., quantity, measurements, age).
* Includes basic settings like:
  * **Name on Product page/ Cart page**
  * **Required field**
  * **Hidden field**
  * **Add-on price**
* **Min/Max Value**:\
  Set the allowed range for number input (e.g., min = 1, max = 100).

<figure><img src="/files/wkLKkuUHs0spKtvdYH6F" alt=""><figcaption></figcaption></figure>

* **Placeholder & Help Text**:\
  Show hints or instructions inside or near the field.

<figure><img src="/files/0N1H7tPqJ3AE4I6BAYTl" alt=""><figcaption></figcaption></figure>

* **Default Value**:\
  Pre-fill the field with a number that must fall **within** the min and max limits.

<figure><img src="/files/sEjnQzp5xr09xNOXx3ze" alt=""><figcaption></figcaption></figure>

In the **Advanced Settings** tab, you can configure similar options as those available for the [**Text** and **Textarea** elements.](/options/option-elements/input-type-options/text-and-textarea)

**📱 Phone Field:**&#x20;

The **basic settings** for the Phone field are similar to other input fields (e.g., label, name, required field, placeholder, etc.).

In the **Advanced Settings** tab, you can configure specific options for phone inputs, including:

* **Validate international phone numbers**\
  Ensures the entered number follows international phone formats.
* **Display country flags and codes**\
  Adds a country flag and dial code selector to the field.
* **Select default country**\
  Choose a default country that will be pre-selected in the input.

<figure><img src="/files/FFiQi19ZYJI3JtEeFS2E" alt=""><figcaption></figcaption></figure>

The other setting can be configured same to other elements.

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Email Field Element

The **Email field** is a form input designed specifically to collect customer email addresses. It ensures the format entered is a valid email structure (e.g., <name@example.com>), helping reduce errors and improve the quality of collected data.

***

<figure><img src="/files/ZA7wRT0PhiuVPStF6YxE" alt=""><figcaption></figcaption></figure>

**🔧 Basic Settings**

You can configure the following options for the Email field:

* **Name on Product page/ Cart page**: Customize the name shown next to the email field.
* **Required Field**: Make this field mandatory before submission.
* **Add-on Price**: Add an additional charge if the email field is part of a special service or feature.
* **Placeholder / Help Text**: Provide a hint or instruction inside or near the field to guide customers.
* **Default Value**: Pre-fill the field with an email value (optional).
* **Conditional Logic**: Show or hide this field based on the values of other fields.

***

**⚙️ Advanced Settings**

The Email field also supports advanced customization, similar to other text-based input elements:

* **Text Transform**: Choose how the text is displayed (e.g., none, uppercase, lowercase).
* **Helptext Position**: Set where the help text appears (e.g., below label, below element, above element, tooltip).
* **Suffix / Prefix**: Add text before or after the field (e.g., "@example.com").
* **HTML Class**: Add custom CSS classes for more styling control.
* **Column Width**: Adjust how wide the field appears in the layout.

***

**✅ Validation**

This field automatically validates that the input is in the correct email format. If not, users will be prompted to enter a valid email before submitting the form.

<figure><img src="/files/DA7zHyTxkbiCHyVob4MG" alt=""><figcaption></figcaption></figure>

***

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Hidden Field Element

The **Hidden Field** is a special input type used to store information in the background that isn't visible to customers on the storefront. It's typically used to pass internal data, or support advanced customization needs without user interaction.

***

<figure><img src="/files/vFQGinjj29XnDyd40lOg" alt=""><figcaption></figcaption></figure>

**🔧 Common Use Cases**

* Include additional order information for backend processing.
* Store default values used for logic or calculations.

***

**⚙️ Configuration Options**

Even though it's not visible to customers, the hidden field supports many of the same settings as other elements:

* **Name on Product page/ Cart page**: Used internally to identify the field.
* **Default Value**: The value automatically included when the form is submitted.
* **Conditional Logic**: Show or activate this field based on other field values.
* **Advanced Settings**:
  * You can assign **HTML classes** if needed for further customization.
  * **Column width** and visual settings are not applicable, since the field is hidden from view.

<figure><img src="/files/K7sSKj7aAfeuZCEVx8Db" alt=""><figcaption></figcaption></figure>

***

**🔒 Important Notes**

* The value in the hidden field is still submitted with the order and can be accessed on the backend.
* Customers won’t see or interact with this field on the storefront, but it's useful for internal workflows, automation, or integrations.

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!

***


# File Upload Element

The **File Upload Field** allows customers to upload their own files directly on the product page — perfect for personalized products like custom prints, logos, or documents.

***

<figure><img src="/files/rhruHV82qsZiyqfDYzJ2" alt=""><figcaption></figcaption></figure>

**🔧 Basic Configuration**

* **Name on Product page/ Cart page**: Customize the label to explain what file the customer should upload.
* **Required Field**: Check this option if uploading a file is mandatory before checkout.

***

**➕ Allow Multiple Uploads&#x20;*****(Pro Plan Feature)***

* By default, customers can upload **only one file at a time**.
* With the **Pro Plan**, you can enable **multiple file uploads**.
* You can **limit the number of files** customers can upload (up to **20 files** max).

ere's how to set up a field so customers can upload their own file

1. **Make basic change to Label/ name/ Required field**
2. **Allow Multiple**&#x20;

As default, customers can upload 1 file/ time. This multiple upload function is available in Pro plan. You can limit how many files they can upload. Maximum to 20 files:&#x20;

<figure><img src="/files/tHnTC4ZNrwrPvck6oEMP" alt=""><figcaption></figcaption></figure>

3. **📂 Allowed File Extensions**

   * Specify which file formats are allowed (e.g., `.jpg`, `.png`, `.pdf`, `.docx`, etc.).
   * This helps control what types of content are submitted and ensures compatibility.

<figure><img src="/files/RPrjTWoHCBIrJ8Vb6nv7" alt=""><figcaption></figcaption></figure>

4. **🧠 Conditional Logic**
   * Use **Conditional Logic** to show or hide the file upload field based on other input values.
   * Great for customizing form behavior depending on customer selections.
5. **⚙️ Advanced Settings**

   Supports the same advanced settings as other elements, including:

   * HTML Class
   * Column Width
   * Help Text Position
   * Text Transformation
   * Enable Image Editor

<figure><img src="/files/5EpW2utUn8XHdFLSdm6f" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Aa6uzUaL7HEIfJhYrkks" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**&#x20;

We’re always here and happy to help — with sincerity and care!


# Color Picker

The **Color Picker** element enables customers to select a custom color using an interactive color panel. It's ideal for customizable products where the color of the item or text is important.

***

<figure><img src="/files/wM0udTZUh4OEZccRTzFW" alt=""><figcaption></figcaption></figure>

**🔧 Basic Settings**

* **Label / Name**: Customize the label to guide users.
* **Required Field**: Make the color selection mandatory if needed.
* **Default Value**: Set a default color (via hex code) to be pre-selected when the page loads.

<figure><img src="/files/74EkqZfPqyIvsLV2vjFQ" alt=""><figcaption></figcaption></figure>

**💡 Advanced Settings**

* **Color Preview Function**:\
  This feature allows the selected color from the **Color Picker** to be linked to elements such as a **Text Box**, **Text Area**, **Heading**, or **Paragraph**, enabling a **real-time preview**.

  🎨 *Example:*\
  When a customer chooses a color and types into a text field, or views static content like a heading or paragraph, the **text will dynamically reflect the selected color**. This enhances interactivity and lets customers better visualize personalized options.

<figure><img src="/files/ALrCoAvVTZMpUzKXuz45" alt=""><figcaption></figcaption></figure>

For other setting of Help text position/ HTML class /Column width, You can set up the same as other elements&#x20;

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Switch button element

The **Switch** element is a toggle-style input that allows customers to enable or disable a specific option. It's visually similar to a light switch or mobile setting toggle, offering a clean and user-friendly experience.

<figure><img src="/files/7BsEtW8wy40VEeAg1EPw" alt=""><figcaption></figcaption></figure>

**🔧 Basic Settings:**

* **Label / Name**: Customize the title of the switch.
* **Required Field**: Make the switch mandatory before proceeding.
* **Add-on Product / Price**: Attach an additional product or cost if the switch is enabled.
* **Default Value**: Set the switch to ON or OFF by default.
* **Conditional Logic**: Use conditions to show or hide the switch based on other field values.

**⚙️ Advanced Settings:**

* **Suffix/Prefix**: Display additional text before or after the switch.
* **Help Text & Position**: Add helper text and choose its position (above, below, tooltip, etc.).
* **HTML Class**: Add custom styling if needed.
* **Column Width**: Adjust the width of the switch field to fit your layout.

**🧠 Use Case Examples:**

* Enable gift wrapping
* Add extended warranty
* Opt-in for personalized engraving
* Toggle special packaging or services

This element adds flexibility and improves the buying experience by allowing customers to make quick yes/no decisions with a simple click.

<figure><img src="/files/iUvBScmZ1tc3pQQAoYKD" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Range Slider

The **Range Slider** element allows customers to select a numeric value from a defined range by dragging a slider. It’s perfect for input fields where you want customers to choose a value within a set limit, offering a clean, interactive experience.

<figure><img src="/files/nfEGKaBNuKGwL8szcrl3" alt=""><figcaption></figcaption></figure>

**🔧 Basic Settings:**

* **Label / Name**: Customize the label displayed above the slider.
* **Required Field**: Make it a mandatory field.
* **Add-on Product / Price**: Assign an additional cost based on the selected value.
* **Min / Max Value**: Set the lowest and highest numbers allowed.
* **Step Value**: Define the increments (e.g., 1, 5, 10).
* **Default Value**: Choose a value that will be selected by default.

<figure><img src="/files/Zk0d1btAiCJoFeNZtlWg" alt=""><figcaption></figcaption></figure>

**⚙️ Advanced Settings:**

* **Prefix & Suffix**
* **Help Text & Position**: Add guidance or notes to help users understand the function.
* **HTML Class**: Apply custom styles via CSS classes.
* **Column Width**: Adjust how wide the slider appears within the form layout.
* **Conditional Logic**: Show or hide this field based on other selections.

**🧠 Use Case Examples:**

* Choose donation amount
* Select quantity for bulk pricing
* Adjust print size or dimensions
* Set customization preferences (e.g., brightness, opacity)

The range slider is both visually appealing and user-friendly, making it a great alternative to text-based number inputs.

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Dimension

*<mark style="color:red;">**Note: This function is not supported on POS Sale Channel.**</mark>*&#x20;

<figure><img src="/files/PY5JnQdBB8rLgCTSAgzw" alt=""><figcaption></figcaption></figure>

#### ⚙️ Basic Features:

The **Dimension** option type allows customers to enter custom measurements such as width, height, or length.

* This option is ideal for products that require precise sizing, such as bed sheets, postcards, or tailored clothing.
* Customers can input their desired dimensions directly when selecting the product.

**Pricing Configuration:**

* Admins can define a custom pricing formula based on the entered dimensions.
* The system automatically calculates the final price using the provided values.
* This allows flexible pricing for made-to-order or size-based products.

#### 🛠️ Advanced Settings:

The option name and option label can be set up normally as other element.&#x20;

**Option values:**&#x20;

* **Label x/y/z:** Use this setting to define names for each dimension (for example: Length, Width, Height). You can configure between 1 and 3 dimensions as needed.

<figure><img src="/files/G7NCl03VfyRMoRKjthbJ" alt=""><figcaption></figcaption></figure>

* **Placeholder:** Use this field to display a short hint or example inside the input box. The placeholder text helps guide users on what information to provide, but it will not be saved as actual input.

<figure><img src="/files/abfYXKAZWjvIuyqmNYbk" alt=""><figcaption></figcaption></figure>

* **Unit:** Use this field to define the measurement unit for the dimension (for example: cm, mm, inch). The unit will be displayed alongside the value to provide clarity for users.

<figure><img src="/files/vWaIZcCH0oqI4x6sTkUU" alt=""><figcaption></figcaption></figure>

* **Default value:** Use this field to set a pre-filled value for the input. This value will appear automatically, but users can change it if needed.&#x20;

<figure><img src="/files/h45i8XIptHIhR24D2eqW" alt=""><figcaption></figcaption></figure>

* **Min / Max Value:** Use these fields to define the allowed range for the input. Set a minimum value and/or maximum value to control what users can enter. Values outside this range will not be accepted.

<figure><img src="/files/SSLKxFa6y4Q6BokPDVFF" alt=""><figcaption></figcaption></figure>

* **Help Text:** Use this field to provide additional guidance or instructions for users. The help text appears alongside the input and can clarify what information is required or how to fill it in correctly.&#x20;

**Add-on Setting**

* Add-on price and formula: Use this setting to apply an additional cost based on the selected option or entered value. You can define a fixed price or use a formula to calculate the price dynamically (for example, based on dimensions or quantity).&#x20;

<figure><img src="/files/HQVgaZygRX1tcbW4EkrI" alt=""><figcaption></figcaption></figure>

**Conditional Logic**

Use this setting to control when an option is displayed based on user selections. You can create rules to show or hide fields dynamically, helping simplify the interface and guide users through relevant choices only.

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Selection Option Type


# Dropdown and Select

<figure><img src="/files/TroAQL3j84AVinuOrEKK" alt=""><figcaption></figcaption></figure>

#### 🔽 Dropdown vs. Select

**Dropdown** and **Select** are the **same element** in terms of functionality — they both allow customers to choose a single value from a list of options. The only difference is **how they look on the storefront**.

* **Dropdown**: Displays as a traditional dropdown menu.
* **Select**: Has a more modern or styled appearance, but still works the same way.

<figure><img src="/files/oCGPVSHqffaZph2e0wQi" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/O38wvm3EAv1GLAc0fe3d" alt=""><figcaption></figcaption></figure>

**🔧 Basic Settings:**

You can customize the following:

* **Label** / **Name**: Edit the label text or field name.
* **Required Field**: Specify whether customers must make a selection.
* **Hidden Field**: Optionally hide the field from customers.

**➕ Allow Multiple Selection:**

* For **Dropdowns** and **Select** elements, you can choose whether to allow **multiple selections**. This is useful for options where customers might want to select more than one choice (e.g., multiple product features or color options).&#x20;

<figure><img src="/files/KYiEeTNZsVvNXECp3xLm" alt=""><figcaption></figcaption></figure>

In the Advanced setting, you can set up similarly to other elements&#x20;

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Image and Color Dropdown

The **Image Dropdown** and **Color Dropdown** elements allow you to present color and image options in a dropdown format, providing a visual representation of the available choices for your customers. This can improve the user experience by making it easier to select color or image options directly from a dropdown menu.

<figure><img src="/files/Z7iullf6CU1JPwgnELNZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/3zygETBcggPANniO4VbN" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/eYvQSshrC6Tb2IYFa2ep" alt=""><figcaption></figcaption></figure>

## General for Both elements:&#x20;

1. **Label**:
   * Set a label for the element that will appear next to or above the dropdown, guiding customers on what to select (e.g., "Select your color" or "Choose an image").
2. **Name**:
   * Define a unique name for the field that helps identify it in your store's backend.
3. **Required Field**:
   * Mark the field as required, meaning customers will need to select an option before they can proceed with the purchase.
4. **Hidden Field**:
   * Optionally hide the element from the storefront, but keep it available for other purposes like custom scripts or hidden data tracking.
5. **Allow Multiple Selection**:
   * Enable customers to select more than one option at once from the dropdown (for both Color and Image dropdowns). This is useful for multi-option selections like multiple colors or images.
6. **Conditional Logic**:
   * Set conditions for when this dropdown element should appear based on previous selections. For example, only show color options when a customer selects a specific product variant.
7. **Search Suggestion:**&#x20;

<figure><img src="/files/QMqRstDCJk500DdnCALS" alt=""><figcaption></figcaption></figure>

8. **Not allow deselect:** By default, many color selectors may offer a "None" or "Clear" option. To prevent deselecting, ensure this option is removed or hidden in the dropdown.
9. **Out of stock options:** In the **Image** and **Color Dropdown** elements, you can control how out-of-stock options are displayed to the customer. This feature helps improve the user experience by visually indicating which options are unavailable.

   \
   The out of stock option can be **Show/ Hidden/ Blur/ Strike through.**&#x20;

<figure><img src="/files/TYlr61jASk9aASKPze5O" alt=""><figcaption></figcaption></figure>

## Specific Features for Image and Color Dropdown&#x20;

* **Color Dropdown**:
  * Color preview: Similar to the [**Color Picker**](/options/option-elements/input-type-options/color-picker) element, the **Color Dropdown** allows you to display a color preview for each option in the dropdown. When a customer selects a color option, the preview will show them a small color sample to help them visualize their choice.
* **Image Dropdown**:
  * Image display outside dropdown: By showing images outside the dropdown, it’s easier for customers to visualize their options, which could lead to higher conversion rates.

<figure><img src="/files/SPI8r6ypXdNLzNJqOhLl" alt=""><figcaption></figcaption></figure>

Both of these dropdown types help you to enhance the visual appeal of your product selection process, providing customers with an intuitive and interactive way to choose options.

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Radio Button and Checkbox

Both **Radio Button** and **Checkbox** elements are designed to present selectable options to your customers. While they function similarly in many ways, there are key differences in **how selections work** and how many can be made.

<figure><img src="/files/hL2DiGYpUjnMqPYGOP9P" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/zL6vYFN53KEimTMMPKjG" alt=""><figcaption></figcaption></figure>

***

#### 🔘 **Radio Button**

* **Purpose**: Allows the customer to **select only one** option from a list.
* **Selection behavior**:
  * Only one value can be selected at a time.
  * Once selected, **it cannot be deselected** — only replaced by selecting another option.
* **Use Case**: Ideal when you want the customer to **choose one and only one** required option — for example, size (Small, Medium, Large).

***

#### ☑️ **Checkbox**

* **Purpose**: Allows the customer to **select multiple options** from the list.
* **Selection behavior**:
  * Multiple checkboxes can be selected.
  * Customers can **deselect** any option freely.
  * You can limit selection by setting up Min/Max selections
* **Use Case**: Perfect for optional add-ons, such as "Include gift wrapping," "Add greeting card," or selecting multiple toppings for a pizza.

***

#### ⚙️ **Shared Settings**

Both **Radio Buttons** and **Checkboxes** allow you to configure:

* **Label/Name**
* **Required Field**
* **Hidden Field**
* **Add-on Products**
* **Conditional Logic**
* **Out of stock options**
* **Advanced Settings** (like Helptext position, Column width, HTML class, etc.)
* **Style**: Vertical/Horizontal&#x20;

<figure><img src="/files/WTH9OsW7AdTJlYbgx8Vc" alt=""><figcaption></figcaption></figure>

* **Expand/collapse option values**&#x20;

<figure><img src="/files/LMIyrsLiSoaOtlpIgusF" alt=""><figcaption></figcaption></figure>

* **Scroll type: Default, By Fixed height, By number of option value**

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Button Element

The **Button** element is a flexible and visually appealing option that lets customers select one or more values by clicking on stylized button choices — similar in functionality to **Radio Buttons** and **Checkboxes**, but with a more modern look.

<figure><img src="/files/UHagQwZOdK8MgdT2zRXp" alt=""><figcaption></figcaption></figure>

#### 🧩 **How It Works**

* Buttons appear as clickable blocks (not dropdowns or standard input fields).
* They can be configured for:
  * **Single selection** (like radio buttons)
  * **Multiple selections** (like checkboxes)

***

#### ⚙️ **General Settings**

You can customize the following settings in the **Basic Configuration**:

* **Label / Name**: Change the title of the field.
* **Required Field**: Force customers to make a selection before proceeding.
* **Hidden Field**: Hide the field from view if needed (used for logic or advanced workflows).
* **Helptext**
* **Add-on Price**: Attach a price to specific button values.
* **Allow multiple:**

<figure><img src="/files/zy5NZgSx4Du2sbpRlSR1" alt=""><figcaption></figcaption></figure>

* **Default Value**: Pre-select a button when the page loads.

***

#### 🧠 **Advanced Settings**

Just like other elements, the **Button** element supports:

* **Conditional Logic**: Show/hide the element based on other selections.
* **Style:** Horizontal & Vertical:

<figure><img src="/files/jrMf6CpwNMzd2KVjrqIE" alt=""><figcaption></figcaption></figure>

* **Expand/collapse option values**
* **Help text position**
* **HTML Class / Column Width**: For layout and style control.

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Color Swatch and Image Swatch

**Color Swatch** and **Image Swatch** are visually interactive option types that let customers select from a set of choices using **colors** or **images**, instead of traditional dropdowns or text.

***

<figure><img src="/files/Mge6pAewsvkhSsaVRbNv" alt=""><figcaption></figcaption></figure>

**🧩 How They Work:**

* Each value appears as a clickable color block or image.
* Customers can easily tap or click to choose their desired option.
* You can allow **single** or **multiple selections** depending on your configuration.

***

<figure><img src="/files/zmrKRlgOkEoVJGKqPyum" alt=""><figcaption></figcaption></figure>

#### ⚙️ General Settings:

For both elements, you can configure the following:

* **Label / Name**
* **Required Field** (force selection before proceeding)
* **Hidden Field**
* **Helptext**
* **Add-on Price** for specific selections
* **Allow Multiple Selection**
* **Default Value**
* **Conditional Logic**
* **Mix/Max selection**
* **Style: Veritial/Horizontal**
* **Out-of-Stock Style**: You can customize how out-of-stock options appear — *show, blur, strike through,* or *hide*.
* **Expand/collapse option values**

***

#### 🎨 Specific Features for Color Swatch:

* **Color Picker Integration**: You can define swatch colors using HEX codes.
* **Preview Functionality**: When linked with elements like Text Box, the selected color can be shown as a real-time preview.

***

#### 🖼️ Specific Features for Image Swatch:

* **Upload custom images to represent each option.**
* **Tooltip Style:**

<figure><img src="/files/VWqcN5CALtWU0OvEpprp" alt=""><figcaption></figcaption></figure>

***

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Show Image / Color Swatch slider

This feature allows you to display option values in a **slider format** for Image Swatch and Color Swatch elements — giving your storefront a cleaner and more organized look.

## <mark style="color:blue;">Steps to manage:</mark>&#x20;

{% stepper %}
{% step %}

### Set up Image and Color Swatch

Add all your desired **option values** to the element.
{% endstep %}

{% step %}

### Enable custom layout

* Go to the **Advanced Settings** tab > Enable **Custom Layout**.
* Under **Layout Type**, select **Slider**.
* Configure the display:
  * Choose the **number of rows**
  * Set the **number of swatches per row**

<figure><img src="/files/4rvtxNLGIAOJKpcOnxTD" alt=""><figcaption></figcaption></figure>

* Enable **Show navigation arrows** and/or **Show indicators** if desired

<figure><img src="/files/8yhfTtT9pIJyREHlPzps" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click Save to apply the change

{% endstep %}

{% step %}

### Preview on the site&#x20;

{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Font Picker Element

The **Font Picker** element allows customers to choose a font style from a predefined list. It’s perfect for personalized products like custom signs, apparel, or engraved gifts — giving customers the freedom to style their text just the way they like.

***

<figure><img src="/files/ONb6N5NlrXMzrGVoNaEV" alt=""><figcaption></figcaption></figure>

### 🎯 Purpose

The Font Picker enables customers to visually preview and select their preferred font style directly on the product page. This enhances the personalization experience and increases customer confidence in their selections.

### 🌐 Font Sources

You can choose from two types of font sources:

1. **Google Fonts (Default)**
   * All standard Google Fonts are supported and available for quick selection.
2. **Custom Fonts**
   * Upload your own font files via:\
     **Settings > Design > Font Upload**
   * Accepted formats: `.woff`, `.ttf`, `.otf`
   * Once uploaded, your custom fonts will appear in the font list for use in the Font Picker element.

<figure><img src="/files/3Ex67EJQaHDfERD7qnzR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fOFYc6ea7aqTvwqh3RY0" alt=""><figcaption></figcaption></figure>

### ⚙️ General Settings

You can configure the following:

* **Label / Name** – Customize the title of the field
* **Required Field** – Make font selection mandatory
* **Hidden Field** – Hide from the frontend but use in logic or workflows
* **Default Value** – Preselect a font when the page loads
* **Help Text** – Add descriptions or instructions to guide customers

***

### 🧠 Advanced Settings

Font Picker supports advanced customizations like:

* **Conditional Logic** – Show or hide the font field based on other selections
* **Help Text Position** – Choose where to display (above, below, tooltip)
* **HTML Class / Column Width** – Adjust spacing and style in your layout

***

### 🎨 Style Options

* **Style Display**: Choose between
  * **Dropdown**: Clean list-style selector
  * **Button**: Clickable font blocks for a modern UI

<figure><img src="/files/NzDyuDVbCnFYleyiRE3r" alt=""><figcaption></figcaption></figure>

* **Font Preview**: Fonts display in their actual style to help customers visualize their text.

<figure><img src="/files/hNEvioURFPCN8oaxuAk3" alt=""><figcaption></figcaption></figure>

* **Search Suggestion**: Enable search to help users quickly find their desired font in long lists.

<figure><img src="/files/G4pW1zCE24NSzTPYT8Nr" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**


# Product Links

The **Product Links** allows you to redirect customers to a **product page** when they click on an option. This is useful when you want to guide users to other related or recommended products directly from the product page.

***

<figure><img src="/files/WrdDAQWeNIino1JJceyn" alt=""><figcaption></figcaption></figure>

### 🧩 How It Works

Each option value in this element is linked to a **Shopify product**. When a customer selects an option, they are automatically **redirected to the corresponding product page**.

***

### 🛠️ How to Set It Up

#### 1. **Add the Product Links Element**

In your option set, add a new **Product Links** element.

#### 2. **Set Up Option Values**

Choose existing products from your Shopify store to assign to each option value. Each value becomes a clickable link to that product page.

<figure><img src="/files/ArPAkRbateoQmHxBypgj" alt=""><figcaption></figcaption></figure>

You can configure the following basic settings:

* **Label / Name** – Set the title that appears above the option.
* **Required Field** – Make it mandatory for the customer to choose an option before proceeding.
* **Hidden Field** – Hide the element from customers (can still be used in logic or for advanced setups).
* **Helptext** – Show supporting information below the label to guide the customer.
* **Placeholder** – Show a default prompt in dropdown-style displays.
* **Default Value** – Pre-select an option on page load (optional).
* **Conditional Logic** – Show or hide this element based on selections made elsewhere on the form.

#### 3. **Choose Display Style**

Select how the options will appear:

* **Dropdown** – Compact list format

<figure><img src="/files/m9WRuDioPa7YFIuAlEhI" alt=""><figcaption></figcaption></figure>

* **Radio Button** – Simple bullet-style choices

<figure><img src="/files/XoIbeuN9Wrdp638k4l5N" alt=""><figcaption></figcaption></figure>

* **Button** – Modern, clickable buttons

<figure><img src="/files/JW6BlVoYv434LXqWwpZr" alt=""><figcaption></figcaption></figure>

* **Color Swatch** – Visual color options

<figure><img src="/files/sqYGkX4I80mROpuUtiO3" alt=""><figcaption></figcaption></figure>

* **Image Swatch** – Image-based options using product photos or you can upload other images for them:&#x20;

<figure><img src="/files/Nt2Fz9xsJyIWd8MMSF9r" alt=""><figcaption></figcaption></figure>

#### 4. **Save & Preview**

After assigning links and setting your display style, save the changes and test it on your storefront.

***

### 💡 Example Use Cases

* Let customers switch between similar styles or related products.
* Use color swatches to link to different color versions of the same product.
* Guide shoppers to alternate designs or editions of a product.

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**


# Static Option Type


# Heading element

The **Heading element** is a static text field used to display a title or section header on your product page. It helps organize your form by separating groups of options or adding clear instructional text.

***

<figure><img src="/files/QGEd4dRqVRDBLTr1XRcZ" alt=""><figcaption></figcaption></figure>

#### ⚙️ Available Settings

* **Content**:\
  This is where you enter the heading text that will be shown to customers. Use it to label sections like “Customization Options” or “Step 1: Choose Your Size”.
* **Color**:\
  Customize the text color of the heading to match your brand or theme design.
* **Style**:\
  Choose the visual appearance of the heading. Options include:
  * H1
  * H2
  * H3
  * H4
  * H5\
    This affects the size and weight of the heading.
* **Conditional Logic**:\
  You can control when the heading appears by using conditional logic based on customer selections in other fields.
* **HTML**
* **Column width**

<figure><img src="/files/wGvP8l0zj0MNNEQiuB4D" alt=""><figcaption></figcaption></figure>

***

#### 💡 Use Case Example

Add a heading like **“Personalize Your Product”** above a group of custom text fields to clearly guide customers through their options.

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Divider & Spacing

<figure><img src="/files/BgJAqre1DCRz4ojCezdV" alt=""><figcaption></figcaption></figure>

#### ➖ Divider Element

Use this to add a visual break between sections on your form.

**⚙️ Settings:**

* **Color** – Set the color of the line.
* **Style** – Choose how the line looks:
  * Solid
  * Double
  * Dashed
  * Dotted
* **Thickness (px)** – Adjust how thick the line appears.
* **Conditional Logic** – Show/hide based on other field values.
* **HTML Class** – Add custom CSS class for styling.
* **Column Width** – Control how wide the divider spans.

<figure><img src="/files/0jdjcGeJA1z2KjgaWV0Y" alt=""><figcaption></figcaption></figure>

***

#### ⬜ Spacing Element

Use this to create vertical space between elements.

**⚙️ Settings:**

* **Height (px)** – Set how much vertical space to add.
* **Conditional Logic** – Show/hide space based on user selection.
* **HTML Class** – Add custom class for advanced styling.
* **Column Width** – Adjust how much horizontal space it takes up.

<figure><img src="/files/MwtpClrmkGJdKK3OsR3D" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Pop Up Modal And Paragraph

<figure><img src="/files/CTOXW4gLk8lfrXz9fz4a" alt=""><figcaption></figcaption></figure>

## How to add Image to Pop-up Modal and Paragraph

#### Steps to Manage:

1. **Go to Shopify Dashboard**\
   Navigate to: `Content → Files → Upload files`
2. **Upload Your Image**\
   Upload the image file you want to display in your popup or paragraph.
3. **Copy the Image URL**\
   After uploading, copy the image URL provided by Shopify.

<figure><img src="/files/DVGxaFsmwXlst2rj0F6C" alt=""><figcaption></figcaption></figure>

4. **Preview the Image**

* Open a new browser tab
* Paste the copied URL
* Right-click on the image
* Select **“Copy image”** (or copy image address)

<figure><img src="/files/cqYuBdBo2yYujizlajcy" alt=""><figcaption></figcaption></figure>

5. **Go to Globo Product Options App**

* Open the **Popup Modal** or **Paragraph** element
* Paste the image tag or URL inside the **content field**

<figure><img src="/files/445xDv61C0GH4wuJwUCH" alt=""><figcaption></figcaption></figure>

## Difference in Pop-up modal & Paragraph

These two elements offer different ways to present additional information on your product pages — mainly in **how the content is displayed**.

#### 🔳 **Popup Modal**

* Displays content **only when a button is clicked**
* Best used when you want to **keep the page clean** and **reduce visual clutter**
* Ideal for **images**, size guides, or extra instructions
* Image/content is hidden until the customer **clicks a button to open a popup**
* Content support: **Images only** (mainly used for visuals)

<figure><img src="/files/ctJmxviCSeKkC9TdqTdF" alt=""><figcaption></figcaption></figure>

#### 📄 Paragraph Element

The **Paragraph** element is designed to display rich content — **text and/or images** — directly on the product page **without any need to click a button**.

* **🖼 Direct Image Display**\
  Any image added will appear immediately on the page, no pop-up or interaction needed.

<figure><img src="/files/zUwwAKjsAf66FnJdzqUd" alt=""><figcaption></figcaption></figure>

* **💬 Customizable Text Content**\
  You can add and format text just like using a word processor. This includes:
  * **Headings** (H1, H2, H3…)
  * **Fonts**: Choose different font families and sizes
  * **Line type**: Adjust line breaks or dividers
  * **Line spacing**: Control how compact or spaced the text appears
  * **Tabs & alignment**: Align content and organize with indentations
  * **Colors & styling**: Bold, italic, underline, font color, and background color

<figure><img src="/files/zmopRT6OthJgsT6F8Rj6" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# HTML element

<figure><img src="/files/KreEbpkUJTSHY2KJDaFo" alt=""><figcaption></figcaption></figure>

The **HTML Element** allows you to add **custom HTML code** directly into your product options form. This is useful when you want to insert things like:

* Custom messages
* Links
* Images
* Embedded videos
* Any advanced formatting or layout using HTML

**⚙️ Settings:**

* **HTML Content** – Paste or write your HTML code here.
* **Conditional Logic** – Show or hide the HTML element based on other selections.
* **HTML Class** – Add a custom CSS class to style the block if needed.
* **Column Width** – Adjust how much horizontal space this element takes up in the layout.

***

💡 **Use Case Examples**:

* Add a YouTube video tutorial
* Insert a styled note or warning
* Link to a product guide or external page

<figure><img src="/files/EoxWU7SMsWwKI5eVGS31" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)

We’re always here and happy to help — with sincerity and care!


# Size chart element

The **Size Chart** element is designed to help customers choose the right size by viewing a **popup** with sizing details like images, text, and tables.

When customers click on the chart icon, a **popup modal** will appear with your custom content.

***

<figure><img src="/files/f4UXcWcg6tCBl5gYoce4" alt=""><figcaption></figcaption></figure>

#### ⚙️ Settings & Features:

**🖼️ Content Editor**

You can add:

* **Text content** – Format like the [**Paragraph**](/options/static-option-type/pop-up-modal-and-paragraph) element (headings, font size, spacing, etc.)
* **Images** – Upload a size chart image or visual guide
* **Tables** – Easily insert sizing tables using:
  * **Rows & Columns**
  * **Cell editing**
  * **Table properties** for customization (borders, alignment, etc.)

**📊 Chart Icon**

* A clickable icon will appear on the product page. When clicked, it opens the size chart popup.
* You can customize the **icon** position and appearance.

**📐 Chart Width**

* Set how wide the size chart popup should appear.

**🛠️ Advanced Settings**

* **HTML**: Add custom HTML to style or embed other content.
* **Width / Column Width**: Control the width of the size chart block on your product page.

<figure><img src="/files/YaLSpE9W1IuICzJIbXh9" alt=""><figcaption></figcaption></figure>

***

💡 **Perfect For**:

* Clothing or footwear stores
* Products with detailed sizing info
* Stores that cater to international sizing

Let me know if you'd like help designing the layout or content for your size chart!

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Tab Element

The **Tab** element allows you to organize multiple sections of content within a single block using a tabbed layout — perfect for product descriptions, specifications, policies, or additional info.

Tabs help keep the product page clean and easy to navigate, especially when you have a lot of information to show.

***

<figure><img src="/files/YCKiEXcuUti6DjWnqZnr" alt=""><figcaption></figcaption></figure>

#### ⚙️ Basic Features:

Each **Tab** contains:

* **Tab Title**: The clickable label at the top of the tab (e.g., "Description", "Shipping", "Care Instructions").
* **Content Area**: This supports:
  * **Text formatting** (like in Paragraph elements)
  * **Images**
  * **Tables**
  * **HTML customizations**

You can add multiple tabs and reorder them as needed.

***

#### 🛠️ Advanced Settings:

* **Conditional Logic**: Show or hide the Tab element based on customer selections or logic rules.
* **HTML Class**: For custom styling using CSS.
* **Column Width**: Adjust the layout width of the Tab block on the page.

<figure><img src="/files/b4kxxmXPaf4y1Y94ik8I" alt=""><figcaption></figcaption></figure>

***

#### 💡 Use Cases:

* Organize product features vs specifications
* Separate care instructions, delivery info, and return policies
* Add product-related FAQs

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Add-on Feature


# How to add Add-on price

The **Add-On** function lets you charge an **extra amount** for specific options.\
When a customer selects that option, the extra cost is **automatically added** to the product price.

## <mark style="color:blue;">Referred Terms</mark>

#### Add-on Price

The **Add-on Price** feature allows you to assign an additional charge to specific options within a product.

* When a customer selects an option with an add-on price, the extra cost is automatically applied.
* This amount is added to the product’s subtotal during checkout.
* Use this feature to charge for upgrades, extras, or customizations.

***

#### Add-on Product

The **Add-on Product** feature is used for **stock management purposes**.

* Add-on products are created separately and linked to options.
* They help track inventory when an option is selected.
* Stock levels can be managed directly through these add-on products.
* Refer to the [**Add-on Product Setup Guide** ](/options/add-on-feature/manage-add-on-products) for instructions on how to create and manage add-on products.

## <mark style="color:blue;">Use existing product</mark>&#x20;

This method allows you to link an option value to an existing product in your store.

* The option will inherit the same price as the selected product.
* This is useful when the add-on already exists as a separate product in your inventory.

**Steps:**

1. Open the **Option** element.
2. Click on the **Price** field.
3. Select **Use Existing Product**.
4. Choose a product from your store.
5. Save your selection.

<figure><img src="/files/uGo6vFnXb91Guij5LY78" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/VKt3nvvdHS8PTyeGuufl" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">Automatically generate product</mark>

This method automatically creates an add-on product when you assign a price.

* The generated product is used for **inventory management**.
* This is helpful when you want to track stock for add-ons without creating products manually.

**Steps:**

1. Open the **Option** element.
2. Click on the **Price** field.
3. Select **Automatically Generate Product**.
4. Enter the desired price.
5. Save your selection.
6. Reload the page to see the updated product.

<figure><img src="/files/Yq4G2Rpod0Jsa0GnNDLi" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">Add price directly</mark>&#x20;

This method adds an extra charge directly to the main product without creating or linking any product. \
\
*<mark style="color:red;">**Note: This function is not supported on POS Sale Channel.**</mark>*&#x20;

* No inventory tracking is applied.
* Suitable for simple price adjustments or service-based add-ons.

**Steps:**

1. Open the **Option** element.
2. Click on the **Price** field.
3. Enter the desired price.
4. Save your changes.

<figure><img src="/files/uxPmqalZcShD9G1fO6HG" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Manage Add-On Products

To apply an extra charge to an option, the app links it to an **add-on product**.\
You can:

* Generate a new add-on product in the app automatically.
* Use an existing product from your Shopify store.

When the option is selected, the add-on product’s price is added to the main product’s subtotal.

***

## <mark style="color:blue;">Method 1: Auto-generate a new add-on product</mark>

{% stepper %}
{% step %}

### Enter the price to option value

<figure><img src="/files/iEgN27siPpneUZG28VV0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click Select (without selecting any product)&#x20;

<figure><img src="/files/UIZg98ivohWoPUNJpyBn" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Save and Reload page

App will generate add-on products next to value.&#x20;

<figure><img src="/files/6WTMGNZcZfSltfgKDRCb" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## <mark style="color:blue;">Method 2: Update the Price using an Existing Add-on product</mark>

{% stepper %}
{% step %}
&#x20;In the **Add-On window**, choose an existing product from your **Shopify store** to use as the add-on.

<figure><img src="/files/2hwuH1DgTcmxOULs9khC" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
The **price of the add-on option** will automatically sync from the selected product.

<figure><img src="/files/wHS7j0pm0p5oZx6ps6l5" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
To change the price, simply edit the product directly in your **Shopify admin**, just like any regular product.

<figure><img src="/files/WtueuGgsieMc4shStxQ4" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

#### 🧾 Cart Behavior:

* When a customer selects an option with an add-on product, **both** the main product and the add-on will appear in the **cart**.

<figure><img src="/files/nxBCEwOMOTlcFVdJ01GM" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Advanced Add-on Function

This **add-on quantity feature** is available in the **Paid Plan** and allows you to control how many units of an add-on product are included with the main product.

To access it:\
**Go to your element → Advanced Settings tab → Add-on advanced options**

***

<figure><img src="/files/V1PWWvz2LdVk574XTAiK" alt=""><figcaption></figcaption></figure>

#### 🔧 Add-On Quantity Modes:

1. **Default**
   * Each main product adds **1 unit** of the add-on product by default.
2. **One-Time Charge**
   * The add-on product quantity is **fixed at 1**, regardless of the main product’s quantity.
3. **Fixed Quantity**
   * You set a **specific number** of add-on units that are always added per main product.
   * *Example: Always add 5 add-ons per product.*

<figure><img src="/files/CACPuFKLDzrdo4zNJfwc" alt=""><figcaption></figcaption></figure>

4. **Dynamic Quantity**

* Quantity = *(Defined quantity)* × *(Main product quantity)*
* *Example: You set 2, customer buys 3 → Add-on quantity = 2 × 3 = 6*

<figure><img src="/files/nLSyitq9wYISHc5nKBa1" alt=""><figcaption></figcaption></figure>

5. **Fixed Quantity (By Customer)**

* A **quantity box** appears under the option so customers can enter how many add-ons they want.
* This number is **not multiplied** by the main product quantity.

<figure><img src="/files/nkkHV9MBd3KmZzF2cx9K" alt=""><figcaption></figcaption></figure>

6. **Dynamic Quantity (By Customer)**

* A **quantity box** appears under the option.
* Add-on quantity = *(Customer input)* × *(Main product quantity)*
* *Example: Customer enters 4, main product quantity = 2 → Add-on = 4 × 2 = 8*

<figure><img src="/files/g7pCJa083krZQustgsae" alt=""><figcaption></figcaption></figure>

7. **Mixed Quantity**

* Shows a **quantity selector** for each option value.
* 🔹 *Note: This is only supported for:*
  * **Checkbox**
  * **Button**
  * **Color Swatch**
  * **Image Swatch**

<figure><img src="/files/1Ihnx45tVUzavZzTVg8S" alt=""><figcaption></figcaption></figure>

8. **Per Charecter.** \
   &#x20;

   The **Per Character** feature is used for text input fields and applies a charge based on the number of characters entered.\
   \
   *<mark style="color:red;">**Note: This function is not supported on POS Sale Channel.**</mark>* <br>

   * Each character entered by the customer will be charged according to the add-on price you set.
   * The total cost is calculated automatically based on the length of the input.
   * This is useful for custom text options such as engravings, messages, or personalized content.

<figure><img src="/files/oaC12gZZ141qn1Zt1CfO" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Merge Main product & Add-on products

This function will help to show add-on product with the main product as bundle.

*<mark style="color:red;">**Important note: This function will not be applied if you:**</mark>* &#x20;

* *<mark style="color:red;">**Use Add-on Type: One-time charge.**</mark>*
* *<mark style="color:red;">**Use Add-on Type: Mixed Quantity.**</mark>*
* *<mark style="color:red;">**POS sale channel.**</mark>*&#x20;

## Step to manage

1. From app setting > Setting tab > Add-on price&#x20;
2. Enable the Merge Main product & Add-on products
3. Save

<figure><img src="/files/Z60iKniBncTTgEvcjztw" alt=""><figcaption></figcaption></figure>

Results on Cart Page:&#x20;

<figure><img src="/files/6zEUlHLDrQViEsXr0Yxl" alt=""><figcaption></figcaption></figure>

Result on Checkout page:&#x20;

<figure><img src="/files/4ireCuEeqaqTg7nVDjoS" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# How to Manage Option Stock via Add-On Products

Managing inventory for your product options is crucial — especially when your options are physical items like gift boxes, accessories, or custom add-ons. Our app makes it easy to track stock levels by linking each option to a real product using the **Add-On Product** feature.

**For the detailed setup, you can refer to the instruction video here:**[ **How to Add Price to Options & Manage Stock in Shopify with Globo Product Options**](https://youtu.be/HOSsM8-9uGk?si=-ZRQjTZcAZCIXc0o)

### 🔧 Steps to Manage Stock

{% stepper %}
{% step %}

#### **Create Add-On Product Linked to an Option**

* Use the **auto-generated** add-on product created by our app
* Or **select an existing Shopify product** as an add-on (this syncs the product price automatically)

<mark style="color:orange;">You can find detailed steps in our Add-On Product</mark> [<mark style="color:orange;">setup guide.</mark>](/options/add-on-feature/manage-add-on-products)

<figure><img src="/files/YjYPgCyOmz7rWq63VG3z" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5W3MbjVQ3PNUha9Z7MuD" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/adkHR0yaKcwTsn8Wl9Ef" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Edit SKU and Quantity**

* From the app, click the add-on product name.

<figure><img src="/files/6uSe6vC0XHZeXMTuXBb5" alt=""><figcaption></figcaption></figure>

* This will **redirect you to Shopify's product admin page**.
* Add a **SKU** and set the **quantity**.
* Enable **Track quantity** if it’s not already active.

<figure><img src="/files/POfGi6dujFAt0Xm2dbHw" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

#### **Configure Out-of-Stock Behavior**

You can decide how an out-of-stock option will appear on the product page:

* ✅ **Show** (but disabled/grayed out)
* 🚫 **Hide**
* ❌ **Strike-through**
* 🌫 **Blur**

<figure><img src="/files/6uMu95D6UofXMIdm5a0M" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Save and Preview

{% endstep %}
{% endstepper %}

### 💡 Result

When a customer selects an option linked to an add-on product:

* The option appears in the cart as a separate item
* The stock of that add-on product is automatically deducted
* You get full control and visibility over the option inventory

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Translate Option Values to Multiple Languages

{% stepper %}
{% step %}
**Enable Multiple Languages in Your Shopify Store**

* Go to **Store Settings** in your Shopify admin.
* Click the **Add language** button.
* Select the language you want to add.

<figure><img src="/files/LqNqVnnu52FxA8H4HH9B" alt=""><figcaption></figcaption></figure>

* Click **Publish** to make the new language available.

<figure><img src="/files/lLHxTuUbjaTj7EXfAvat" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Configure Multiple Languages for Option Values**

* From the app’s left navigation, click **Option Sets**.
* Select the option set you want to translate.
* In the top-right corner of the option set page, switch to the language you want to edit.
* Enter the translated text for each relevant field.
  * <mark style="color:orange;">For example: update the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Label**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">field with the translated content.</mark>

<figure><img src="/files/8PQksjgb3OL1hTHyxXNd" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Click **Save** to apply the changes.

Visit your storefront to preview how the translations appear for each languag
{% endstep %}
{% endstepper %}

**Example:**

* **English View:** Displays default language content.
* **French View:** Shows translated option values and labels.

<figure><img src="/files/LcYLwLFOkI8OsEtnAX4a" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/dxR0ySM1uMj1e18V8yNl" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:orange;">⚠️ Important Notes:</mark>

* <mark style="color:orange;">This feature supports translation for the following elements:</mark>
  * <mark style="color:orange;">**Option Label**</mark><mark style="color:orange;">,</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Placeholder**</mark><mark style="color:orange;">,</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Help Text**</mark><mark style="color:orange;">, and</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Swatch Label**</mark>
  * <mark style="color:orange;">**Option Values**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">and</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Help Text**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">related to those values</mark>
  * <mark style="color:orange;">**Static Content**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">fields such as</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Heading**</mark><mark style="color:orange;">,</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Paragraph**</mark><mark style="color:orange;">, and</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**HTML**</mark>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Translate Fixed Text from App

{% stepper %}
{% step %}
From **App Settings**, go to the **Translation** tab.

<figure><img src="/files/Q273AGTmOsRFeCTkPvrs" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Add the language(s) you want to translate.

<figure><img src="/files/ZBCgCB20eDzwIMPTyiso" alt=""><figcaption></figcaption></figure>

Edit the text in the default language or enter the translated version for each selected language.

<figure><img src="/files/dKjga2FN0fYGDCEQgX6m" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Save** to apply changes.
{% endstep %}
{% endstepper %}

The text can appear in:

* **Widget**
* **Cart widget**
* **Add to cart error messages**
* **Validation error messages**<br>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Conditional Logic Function

This feature lets you show or hide option values depending on the choices made in other options or specific Shopify variants.

**For the detailed setup, you can refer to the instruction video here:** [**How to Show or Hide Options using Conditional Logic in Shopify with Globo Product Options**](https://youtu.be/JuUOy6sdNY8?si=mlW03k5RzAWLQN7l)

## Steps to manage:

{% stepper %}
{% step %}
**From Option set, select the option you want to apply conditional logic**&#x20;

<figure><img src="/files/zF59lRig4uEBBjYcxtau" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Turn On Conditional Logic**\
On the left side, in the **Option Configuration** panel, find and check the box called **"Conditional Logic Options."**

<figure><img src="/files/OO8brbb2jKYJnLdXqjOY" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Choose What to Match**

Select whether you want to base your conditions on the **previous option** or **Shopify variants.**

<figure><img src="/files/PDrrTwpLaOsu16sa0fJN" alt=""><figcaption></figcaption></figure>

**For Shopify variants, it is a must to write down exactly the Variant name on products** <br>

<figure><img src="/files/viGuLea6RSBPPu8vZH44" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Set Your Display Rules**\
Decide when the field should appear or disappear based on the conditions you create:

* **Show:** The field will only show up if *all* conditions are true. If not, it will stay hidden.
* **Hide:** The field will hide if *all* conditions are true. Otherwise, it will show.

  <figure><img src="/files/yWwvwHteQak0ZiNW03GQ" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
**Decide How Conditions Work Together**

* **All Conditions (AND):** The field reacts only if *every* condition is true.
* **Any Condition (OR):** The field reacts if *at least one* condition is true.

<figure><img src="/files/Ps8WniSCNeL9GKFQere2" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Set Conditions Between Elements**

Here are the condition types you can use to link elements:

* **Is equal to:** Show the field when the previous option exactly matches your selected value.
* **Is not equal to:** Show the field when the previous option does *not* match your selected value.
* **Is greater than:** (For number fields) Show the field when the previous option is greater than a certain number you set.
* **Is less than:** (For number fields) Show the field when the previous option is less than a certain number you set.
* **Starts with:** Show the field when the previous option starts with the value you specify.
* **Ends with:** Show the field when the previous option ends with the value you specify.
* **Contains:** Show the field when the previous option contains the value you specify.
* **Does not contain:** Show the field when the previous option *does not* contain the value you specify.

<figure><img src="/files/kXXJembcer2hDrVuYhG4" alt=""><figcaption></figcaption></figure>

* **For Text option type (Text/Textarea)**, it allows set up the condition of characters number: To show an element if the text field is filled out the the number of characters you set up:&#x20;

<figure><img src="/files/fsXRMmsVKVF5DM4kH7NI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/TCAlo29DFTTb4NxzDS10" alt=""><figcaption></figcaption></figure>

* **For** **Selection option type** **(Dropdown/Checkbox/Button/Swatch),** it allows set up the condition of selection number. To show an element if the previous option is selected with the number you set up

<figure><img src="/files/IsEmGB8p7YWm5UaU0zU6" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/CNCx9ClRJRbOM8G1QAC4" alt=""><figcaption></figcaption></figure>

* **For Upload file element,** it allows set up to show an element depending on the number of file you set:&#x20;

<figure><img src="/files/ONwm4KyoFCAopPxVI8FS" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Product Personalizer (Live Preview)


# General Look

The **Product Personalizer** function allows you to show a **live option preview** directly on the main product images.\
This helps customers see how their selected options (e.g., text, colors, uploads) will look on the product before purchasing.\
\
For the detailed instruction, you can refer to the video her&#x65;**:** [**How to Setup Live Preview for Custom Products in Shopify with Globo Product Options** ](https://youtu.be/Q8EwrbBIs98?si=Pwy5XGLWk_CCOJkP)

### <mark style="color:blue;">Supported Option Types</mark>

Not all option elements support live preview. Currently, the following option types are supported:

* **Text / Text area**
* **Number**
* **File Upload**
* **Dropdown / Color Dropdown / Image Dropdown**
* **Swatch / Color Swatch / Image Swatch**
* **Radio Button**
* **Checkbox**

### <mark style="color:blue;">Personalize Panel</mark>

* Each option that supports live preview has a **Product Personalizer tab**.
* You can find it in the **top-right corner** of the option’s settings area.
* Other settings (**Basic** and **Advanced**) remain on the left panel.

<figure><img src="/files/F1xRFBelIawJLaSgXbzw" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">Preview Panel Setup</mark>

The **Preview Panel** controls how your option preview is displayed on the product image.

### <sup>1. Enable Personalize Editor</sup>

* Go to the **right tab** of the option settings.
* Switch on the toggle **“Show Personalize Editor”**.

### <sub>2. Select Background</sub>

You can choose what background to use for the preview:

* **Product image** – Use the product image itself as the background.

<figure><img src="/files/xmI79X6L8MluAVXizJom" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GTaAYtpVUPfwl3u9Folw" alt=""><figcaption></figcaption></figure>

* **Custom image** – Upload your own background image to replace the product image.

<figure><img src="/files/sk6fIkG5nOYJXmSITIf3" alt=""><figcaption></figcaption></figure>

### <sub>3. Set Conditions to Apply</sub>

Choose which product images the personalization will be applied to:

* **All product images** – Apply preview to every product image.
* **First product image only** – Apply preview to the first product image.
* **Last product image only** – Apply preview to the last product image.
* **Specific product image** – Select a particular product image to apply the preview.<br>

<figure><img src="/files/EWDHJRiV3DhEouCpZ6ZO" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# How It Works

This document shows you how to set up the live preview for each option element.&#x20;

In each option element, please enable the Personalize Setting.&#x20;

{% stepper %}
{% step %}

### Text - Textarea - Number

* If a **Default value** is set in **Basic settings**, it will automatically appear in the live preview.
* If no default is set, you’ll need to enter one here (e.g., *“Your text”* or *“Your name”*).
* Any changes you make here apply **only to the live preview** and will not sync back to the Basic settings.

<mark style="color:blue;">**Adjust**</mark>:&#x20;

* Text color&#x20;
* Font size
* Text alignment
* Font style
* Font family

<mark style="color:blue;">**Control how the preview element appears on the product image:**</mark>

* **Position** – Adjust placement using **X-Axis** and **Y-Axis**.
* **Opacity** – Set transparency of the preview.
* **Rotation** – Rotate the element to the desired angle.

<figure><img src="/files/SzgvFlMMNWNuL6tWq2U4" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">**Custom effect for text preview:**</mark>

* **No effect**
* **Stroke**
* **Neon light**&#x20;
* **Emboss**

<figure><img src="/files/lh9ynWkdaBTFfrWdoFr4" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">**Allow customers to interact with the preview by enabling:**</mark>

* **Move** – Let customers change the position.
* **Resize** – Let customers adjust the size.
* **Rotate** – Let customers rotate the preview.
  {% endstep %}

{% step %}

### File Upload

When a customer uploads a file, the uploaded image will appear directly on the main product image as a preview.\
\ <mark style="color:blue;">**Image Shape:**</mark>

* Select from the available preset shapes: You can control how the preview looks by changing its **shape** Or upload your own custom shape.

The customer’s uploaded file will be displayed within the shape you configure.

<figure><img src="/files/DyiaoFXpaNVj9ls5PC15" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">**Background Mode:**</mark>

This setting controls how the background image is displayed inside the preview shape area:

* **Stretch** – Forces the image to fill the entire shape (may distort).
* **Cover** – Scales the image to cover the entire shape while keeping proportions (parts may be cropped).
* **Contain** – Scales the image to fit inside the shape without cropping (may leave empty space).
* **Full Width** – Stretches the image across the full width of the preview area.
* **Full Height** – Stretches the image across the full height of the preview area.

<mark style="color:blue;">**You can control how the preview element appears on the product image:**</mark>

* **Position** – Adjust placement using **X-Axis** and **Y-Axis**.
* **Opacity** – Set transparency of the preview.
* **Rotation** – Rotate the element to the desired angle.

<mark style="color:blue;">**You can also allow customers to interact with the preview by enabling:**</mark>

* **Move** – Let customers change the position.
* **Resize** – Let customers adjust the size.
* **Rotate** – Let customers rotate the preview.

<figure><img src="/files/tLY5C8MxPC9qg0OeF3s5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Dropdown - Color Dropdown - Image Dropdown

For each dropdown value, you can **upload an image**. When a customer selects a value, the corresponding image will display on the main product image.

<mark style="color:blue;">**Image Shape:**</mark>

* Select from the available preset shapes: You can control how the preview looks by changing its **shape** Or upload your own custom shape.

The customer’s uploaded file will be displayed within the shape you configure.

<mark style="color:blue;">**Background Mode:**</mark>

This setting controls how the background image is displayed inside the preview shape area:

* **Stretch** – Forces the image to fill the entire shape (may distort).
* **Cover** – Scales the image to cover the entire shape while keeping proportions (parts may be cropped).
* **Contain** – Scales the image to fit inside the shape without cropping (may leave empty space).
* **Full Width** – Stretches the image across the full width of the preview area.
* **Full Height** – Stretches the image across the full height of the preview area.

<mark style="color:blue;">**You can control how the preview element appears on the product image:**</mark>

* **Position** – Adjust placement using **X-Axis** and **Y-Axis**.
* **Opacity** – Set transparency of the preview.
* **Rotation** – Rotate the element to the desired angle.

<mark style="color:blue;">**You can also allow customers to interact with the preview by enabling:**</mark>

* **Move** – Let customers change the position.
* **Resize** – Let customers adjust the size.
* **Rotate** – Let customers rotate the preview.
  {% endstep %}

{% step %}

### Button - Color Swatch - Image Swatch&#x20;

For each value of Button - Color Swatch - Image Swatch, you can upload an image. When customers select that value, the corresponding image will automatically display on the main product image.

<mark style="color:blue;">**Image Shape:**</mark>

* Select from the available preset shapes: You can control how the preview looks by changing its **shape** Or upload your own custom shape.

The customer’s uploaded file will be displayed within the shape you configure.

<mark style="color:blue;">**Background Mode:**</mark>

This setting controls how the background image is displayed inside the preview shape area:

* **Stretch** – Forces the image to fill the entire shape (may distort).
* **Cover** – Scales the image to cover the entire shape while keeping proportions (parts may be cropped).
* **Contain** – Scales the image to fit inside the shape without cropping (may leave empty space).
* **Full Width** – Stretches the image across the full width of the preview area.
* **Full Height** – Stretches the image across the full height of the preview area.

<mark style="color:blue;">**You can control how the preview element appears on the product image:**</mark>

* **Position** – Adjust placement using **X-Axis** and **Y-Axis**.
* **Opacity** – Set transparency of the preview.
* **Rotation** – Rotate the element to the desired angle.

<mark style="color:blue;">**You can also allow customers to interact with the preview by enabling:**</mark>

* **Move** – Let customers change the position.
* **Resize** – Let customers adjust the size.
* **Rotate** – Let customers rotate the preview.
  {% endstep %}

{% step %}

### Radio Button - Checkbox&#x20;

For each value of Radio button or Checkbox, you can upload an image. When customers select that value, the corresponding image will automatically display on the main product image.

<mark style="color:blue;">**Image Shape:**</mark>

* Select from the available preset shapes: You can control how the preview looks by changing its **shape** Or upload your own custom shape.

The customer’s uploaded file will be displayed within the shape you configure.

<mark style="color:blue;">**Background Mode:**</mark>

This setting controls how the background image is displayed inside the preview shape area:

* **Stretch** – Forces the image to fill the entire shape (may distort).
* **Cover** – Scales the image to cover the entire shape while keeping proportions (parts may be cropped).
* **Contain** – Scales the image to fit inside the shape without cropping (may leave empty space).
* **Full Width** – Stretches the image across the full width of the preview area.
* **Full Height** – Stretches the image across the full height of the preview area.

<mark style="color:blue;">**You can control how the preview element appears on the product image:**</mark>

* **Position** – Adjust placement using **X-Axis** and **Y-Axis**.
* **Opacity** – Set transparency of the preview.
* **Rotation** – Rotate the element to the desired angle.

<mark style="color:blue;">**You can also allow customers to interact with the preview by enabling:**</mark>

* **Move** – Let customers change the position.
* **Resize** – Let customers adjust the size.
* **Rotate** – Let customers rotate the preview.
  {% endstep %}
  {% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# Templates with Product Personalizer

To set this up faster, simply choose from the ready-made templates in the app. We provide 20 templates tailored for different purposes.

## Apply a Ready-Made Template

1. From the app’s left navigation, go to **Template tab**.
2. Select **Personalized Templates**.
3. Click **Use template** to apply it directly.

<figure><img src="/files/XVJKBNSFkiNtHBtU2Tg5" alt=""><figcaption></figcaption></figure>

## Add a Personalized Template to an Option set

1. Go to **Create Option Set**.
2. Click **Add Element**.
3. Choose **Personalized Templates** from the list.

<figure><img src="/files/TG8PD8e6rZb8UrZqpy7c" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NeMO6yRrR1F3AXR0a04E" alt=""><figcaption></figcaption></figure>

## Here's the List for templates you can uses:&#x20;

1. [Custom Couple Mugs](https://globo1.myshopify.com/products/custom-couple-mugs)
2. [Custom Football Jerseys](https://globo1.myshopify.com/products/custom-football-jerseys)
3. [Custom LED Acrylic Light Stands](https://globo1.myshopify.com/products/custom-led-acrylic-light-stands)
4. [Custom Notebook](https://globo1.myshopify.com/products/custom-notebook)
5. [Custom Phone Case](https://globo1.myshopify.com/products/custom-phone-case)
6. [Custom Picture Frames](https://globo1.myshopify.com/products/custom-picture-frames)
7. [Custom T-Shirts](https://globo1.myshopify.com/products/custom-t-shirts)
8. [Embroidered Bag](https://globo1.myshopify.com/products/embroidered-bag)
9. [Engraved Pen](https://globo1.myshopify.com/products/engraved-pen)
10. [Personalised BBQ Fork](https://globo1.myshopify.com/products/personalised-bbq-fork)
11. [Personalised Tie](https://globo1.myshopify.com/products/personalised-tie)
12. [Personalised Trophy Gold](https://globo1.myshopify.com/products/personalised-trophy-gold)
13. [Personalised Wooden Ramp Racer Toy](https://globo1.myshopify.com/products/personalised-wooden-ramp-racer-toy)
14. [Personalised Wooden Serving Platter](https://globo1.myshopify.com/products/personalised-wooden-serving-platter)
15. [Personalized Birthstone Pendant](https://globo1.myshopify.com/products/personalized-birthstone-pendant)
16. [Personalized Broken Heart Pendant Necklace](https://globo1.myshopify.com/products/personalized-broken-heart-pendant-necklace)
17. [Personalized Cushion ](https://globo1.myshopify.com/products/personalized-cushion)
18. [Personalized Photo Frame](https://globo1.myshopify.com/products/personalized-photo-frame)
19. [Personalized Wooden Bears Family](https://globo-minh-tuan.myshopify.com/products/personalized-photo-frame)
20. [Unisex Crocs Classic](https://globo1.myshopify.com/products/unisex-crocs-classic)

If you need to build any templates based on your requirement, please feel free to contact us.&#x20;

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!

<br>


# Option Set Analytics

The **Option Set Analytics** feature helps you track how your customers interact with your product options. It provides valuable insights into which options are most popular and how often they’re selected — helping you make smarter business and design decisions.

#### <mark style="color:blue;">How to View Analytics</mark>

{% stepper %}
{% step %}
From the app’s left navigation, go to **Analytics** > **Option Set Analytics**.
{% endstep %}

{% step %}
Select the **Option Set** you want to review.
{% endstep %}

{% step %}
Review the displayed metrics to understand:
{% endstep %}

{% step %}
Filter data by **date range**, **product**, or **option set** to refine your analysis.
{% endstep %}
{% endstepper %}

<figure><img src="/files/8tqon7fwwGJ45VQjPijx" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">What You Can Monitor</mark>

* **Total Views** – Number of times your option sets have been viewed by customers.
* **Revenue from Add-ons** – Total income generated from add-on options.
* **Total Products** – Number of products that include option sets.
* **Total Orders** – Number of orders containing customized or add-on products.
* **Average Order Value** – The average amount spent per order that includes option sets.
* **Total Sales** – Overall sales revenue from products using option sets.
* **Most Valued Options** – Identify which options are most frequently selected or generate the highest revenue.
* **Total Product Quantity** – Total number of product units sold with option selections.
* **Orders Revenue Distribution** – Breakdown of order revenue across various option sets or add-ons.

<figure><img src="/files/AUc1bcWuJwmls9NOziG6" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care


# General Setting

## <mark style="color:blue;">App widget</mark>

#### <mark style="color:blue;">1.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**App Position**</mark>

* You can configure **where the option set is displayed** on the product page.
* 💡 *For details, refer to the "*[*App Position*](/options/app-setting/set-option-set-position-on-product-page)*" section in settings.*

***

#### <mark style="color:blue;">2.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Alignment**</mark>

* Control how the option fields are aligned:
  * **Left**
  * **Right**
  * **Center**
  * **RTL (Right-to-Left)** — useful for Arabic or Hebrew storefronts.

<figure><img src="/files/csvroBiCTPSk54JpeU09" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:blue;">3.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Swatch Tooltip**</mark>

* **Show Swatch Tooltip:**\
  Display the option value (text or image) when customers **hover** over a swatch.

***

#### <mark style="color:blue;">4.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Selected Value Display**</mark>

* **Show Selected Option Value Next to Label:**\
  Toggle ON to show the selected value beside the field label. Helpful for improving clarity.

<figure><img src="/files/aWCdqzk2mMVRFTP7eFBx" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:blue;">**5. Limit Height**</mark>

* Set a **maximum height** for the option set container.\
  If the content exceeds this limit, **a scrollbar will appear** for easier navigation.

<figure><img src="/files/tzOVdw3K86NBRwq91lu7" alt=""><figcaption></figcaption></figure>

***

### <mark style="color:blue;">**Page-specific Setting**</mark>

#### <mark style="color:blue;">1.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Collection Page**</mark>

* **Show Widget on Quickview:**\
  Displays the options directly inside the **Quickview modal** on collection pages.

<figure><img src="/files/ol5PROtEkhE7aeRLCjIP" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:blue;">2.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Product Page**</mark>

* **Redirect to Cart After Adding Product:**\
  Enabled by default for **add-on products**.\
  Only supported on certain themes — [View supported themes](/options/app-setting/list-of-themes-supporting-ajax-cart-function).

<figure><img src="/files/uYmQUJSoer7d9rV6RGm3" alt=""><figcaption></figcaption></figure>

* **Scroll to First Error Message:**\
  Automatically scrolls the page to the first incomplete/invalid field when submitting.

<figure><img src="/files/lJKrNgwamN2dmIZM8qNw" alt=""><figcaption></figcaption></figure>

* **File Preview:**\
  In file upload fields:
  * Image files will show a **thumbnail preview**.
  * Other file types will show a **download link**.

<figure><img src="/files/ufYkixGeMeOqanqGAEzV" alt=""><figcaption></figcaption></figure>

***

#### 🛍️ **Cart Page**

* **Disable Quantity Box & Remove Button for Add-ons:**\
  Prevents customers from deleting add-on products manually, preserving pricing logic.

<figure><img src="/files/6oe0Io0sto787R52rPBZ" alt=""><figcaption></figcaption></figure>

* **Show “Edit Options” Button:**\
  Allows customers to go back and **change their selected options** directly from the cart page.

<figure><img src="/files/64gbJduQVNG4ffvCubOE" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:blue;">3.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Other Pages**</mark>

* **Show Widget on Home Page** *(Featured product section only)*
* **Show Widget on Regular Page** *(Featured product section only)*

<figure><img src="/files/YybjH2Mo8t4KGPloKca3" alt=""><figcaption></figcaption></figure>

***

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**.

We’re always here and happy to help — with sincerity and care


# Add-on Price Setting

#### <mark style="color:blue;">1.</mark>  <mark style="color:blue;"></mark><mark style="color:blue;">**Add-on Money Format**</mark>

You can control how the add-on price is shown next to each option.

* **With/Without Currency**\
  Example: `+ $5.00` or `+ €3.00`\
  The price will include the currency symbol based on your store’s settings.

<figure><img src="/files/u9NRaPybU6BcjGxNynnf" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/h808GHAggrUYp8cahINq" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:blue;">2.</mark>  <mark style="color:blue;"></mark><mark style="color:blue;">**Add-on Label Format**</mark>

Customize how the price is shown beside the option label.

* **Default format:**\
  `(+ {{addon}})`\
  You can modify this format — `{{addon}}` will automatically be replaced by the add-on price.

<figure><img src="/files/TIxJtqyTYlyQpp6sWgag" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">3.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Show Add-on for Inputs**</mark>\
\
Toggle this on to display add-on prices for **input-type elements** such&#x20;

<figure><img src="/files/rpHr522qKx9vL8N1uNef" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/VywUBqgN5D1PK3cOaIuo" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">4.</mark>   <mark style="color:blue;"></mark><mark style="color:blue;">**Show Add-on for Options**</mark>

Enable this to display add-on prices for **selectable options.**

<figure><img src="/files/j3pUoZkuiiPnWEZwFQsQ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/tXiKopIBZH4zRk5nJHHs" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:blue;">5.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Show Add-on Message**</mark>

When enabled, it displays a **note or tooltip** indicating that the selected option will increase the final product price.

<figure><img src="/files/RTIEZnficfamBa4fSQgN" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/8sYnM0PFRCBphM32eedR" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:blue;">6.</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Add Add-on Price to the Product Price**</mark>

This option controls whether the add-on price is:

* Added to the product price dynamically on the storefront
* Helps customers see the updated total price right before checkout

<figure><img src="/files/9gMEX7YF0BxpEsDJPfvh" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/yk4iZUhfKDj0Ug4uZIEg" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**


# Set Option Set Position On Product page

You can easily adjust the position of the **Globo Product Options** widget on your product detail page using Shopify’s **Custom Block** feature or from **App Setting**.

***

## <mark style="color:blue;">Approach 1: Using app block.</mark>&#x20;

#### 📌 Steps to Manage:

{% stepper %}
{% step %}
**Go to your Shopify admin panel**

Navigate to: **Online Store** > **Themes**
{% endstep %}

{% step %}
**Edit your theme**

Find the theme you want to update, then click **Customize**
{% endstep %}

{% step %}
**Select the Product page**

From the top dropdown, choose the **Default Product** template

<figure><img src="/files/7G6za9jZJa8nFUPB0gZe" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Add a new block**

In the left sidebar (under the Template section), click **Add block**
{% endstep %}

{% step %}
**Choose the Globo app block**

* Go to the **Apps** tab
* Select **“Globo Product Options”**

<figure><img src="/files/BP3RpSWgEJsDCwoOu4I6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Drag & drop**

Move the block to your preferred position on the product detail page
{% endstep %}

{% step %}
**Save your change**
{% endstep %}
{% endstepper %}

<figure><img src="/files/PAmZyWmNSZrrK6F73lFp" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">Approach 2: Using App Setting:</mark>&#x20;

{% stepper %}
{% step %}
From your Shopify Admin, go to the **Globo Product Options** app > **Settings**&#x20;
{% endstep %}

{% step %}
**Choose Widget Position**
{% endstep %}

{% step %}
**Select Display Location**

Choose one of the 4 available positions:

* **Above Add To Cart** button
* **Below Add To Cart** button
* **Above Shopify Product Variants**
* **Below Shopify Product Variants**
  {% endstep %}

{% step %}
**Save Your Changes**
{% endstep %}
{% endstepper %}

<figure><img src="/files/tPGeTR1KVLloR8S1GtWx" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!


# List of themes supporting Ajax Cart function

#### 🛒 What is AJAX Cart?

**AJAX cart** enables a smoother shopping experience by allowing customers to add products to their cart **without refreshing the product page**. This often appears as a **mini cart** or **cart drawer** popup.

***

#### ⚠️ Important Notes:

* If your theme **is not listed below**, customers will be redirected to the **Cart Page** after adding a product.
* If your option set **includes add-on products**, the app will **disable the AJAX cart** (even if your theme supports it) to prevent customers from removing add-on products and causing pricing issues.
* In case you use the Add-price directly function, it can work with every themes&#x20;

***

#### ✅ Supported Themes for AJAX Cart:

These themes are confirmed to work seamlessly with our app's AJAX cart feature:

1. Debut
2. Empire
3. Capital
4. Venture
5. Ella
6. Galleria
7. Loft
8. Providence
9. Lorenza
10. Avenue
11. Artisan
12. Prestige
13. Impulse
14. Motion
15. Streamline
16. Focal
17. Warehouse
18. Blockshop
19. District
20. Pop
21. Pipeline
22. Parallax
23. Retina
24. Broadcast
25. ShowTime
26. Enteprise
27. Origin
28. Refresh
29. Colorblock
30. Ride
31. Studio
32. Taste
33. Sense
34. Crave
35. Craft
36. Dawn

***

#### 💬 Need Help?

If your theme isn’t listed or you're experiencing any issues with AJAX cart behavior, don’t hesitate to reach out at [**contact@globo.io**](mailto:contact@globo.io)**.**\
We’re always happy to help!


# Themes Supporting Automatic Match Theme

This feature makes it easier to match the app widget with your theme’s style. The matching process can be done automatically.

Currently, the following themes support automatic integration:&#x20;

1. Atelier
2. Craft
3. Crave
4. Dawn
5. Dwell
6. Fabric
7. Heritage
8. Horizon
9. Pitch
10. Publisher
11. Refresh
12. Ride
13. Ritual
14. Savor
15. Sense
16. Spotlight
17. Studio
18. Taste
19. Tinker
20. Vessel

#### 💬 Need Help?

If your theme isn’t listed or you're experiencing any issues with the layout, don’t hesitate to reach out at [**contact@globo.io**](mailto:contact@globo.io) **or Live chat.** \
We’re always happy to help!


# Change Option Set’s Background Color

{% stepper %}
{% step %}
From the app’s left navigation, click **Settings**.
{% endstep %}

{% step %}
In the **Settings** window, go to the **Design** tab.
{% endstep %}

{% step %}
Under the **App Background** section, choose the color you want to use.
{% endstep %}

{% step %}
Adjust the **transparency** using the bar next to the color picker.
{% endstep %}

{% step %}
Click **Save** to finish.
{% endstep %}
{% endstepper %}

<figure><img src="/files/MK4LSzpvfxmt7haDSyJ4" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**


# Show/Hide Tooltip for Options

You can display a tooltip when customers hover over product options.

***

####

{% stepper %}
{% step %}
Go to **App Settings**.
{% endstep %}

{% step %}
Turn on **Show tooltip when hovering over options**.
{% endstep %}

{% step %}

#### **Choose a Tooltip Style for Each Option Set**

* Open the **Option Set** where you want to add tooltips.
* Go to **Advanced Settings**.
* Select a **Tooltip Style**:
  * **📝 Text** – Displays text only.
  * **🖼 Text & Image** – Displays text with an image.
    * You can customize the **image style** for this tooltip type.
      {% endstep %}
      {% endstepper %}

<figure><img src="/files/fkhXwIhs6ht2OdwQAGbL" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/KnpA81IIN8xkUy3USqfT" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

&#x20;


# Integrate the App with Your Theme

{% stepper %}
{% step %}
From **App Settings**, click **Theme Setup**.
{% endstep %}

{% step %}
**Select a theme** from the *Select a theme to install app* dropdown.
{% endstep %}

{% step %}
Click **Go to Theme Editor**.&#x20;
{% endstep %}

{% step %}
In the Theme Customize page, **enable the App Embed** option.
{% endstep %}

{% step %}
Click **Save** to apply changes.
{% endstep %}
{% endstepper %}

<figure><img src="/files/UAsaUc83dF3CB5iOW7Ce" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/M0bIVzOf2dQqvToBb0O0" alt=""><figcaption></figcaption></figure>

***

#### <mark style="color:orange;">⚠️ Important Notice:</mark>

<mark style="color:orange;">If you want to disable the app’s option set on a theme, just turn off the</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**App Embed**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">for that theme.</mark>

***

**📩 Need help?**\
If you run into any issues creating a new option set, don’t hesitate to reach out! Email us anytime at  [**contact@globo.io**](mailto:contact@globo.io)**.**— we’re here to help with sincere support.


# Display Option on Order invoice

## <mark style="color:blue;">Order Invoice with Shopify Order Printer</mark>

Our Product Options app works seamlessly with Shopify’s Order Printer app, allowing you to include option details directly on printed invoices.

{% stepper %}
{% step %}
From your **Shopify admin**, click on **Apps**
{% endstep %}

{% step %}
Select **Order Printer** from your app list

<figure><img src="/files/W0Ah1eeW4iwrgiIvpUDe" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Manage Templates** > **Invoice**

<figure><img src="/files/iD2PCvWAoMtNygbuQALH" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
📥 **Download the invoice template** *(*[*click this button to download*](https://github.com/globo-software/display-cart-line-item-in-notification/blob/main/gpo-order-invoice.liquid)*)*
{% endstep %}

{% step %}
Open the downloaded file and **copy the code**

```
<div class="gpo-properties">
	{% assign property_size = line_item.properties | size %} 
	{% if property_size > 0 %} 
	{% for p in line_item.properties %} 
	<div class="gpo-property">
		{% assign first_character_in_key = p.first | truncate: 1, '' %}
		{% unless p.last == blank or first_character_in_key == '_' %} 
		<span>{{ p.first }}: </span>
		{%- if p.last contains '/uploads/' -%} 
		<a href="{{ p.last }}">{{ p.last | split: '/' | last }}</a> 
		{%- else -%} 
		{{ p.last }} 
		{%- endif -%} 
		{% endunless %} 
	</div> 
	{% endfor %}
{% endif %} 
</div>
```

Paste the code into the **Template Details** section

<figure><img src="/files/y8592G3BRdzSmvRACDiC" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Save** to apply the change
{% endstep %}
{% endstepper %}

**📩 Need help?**\
If you run into any issues creating a new option set, don’t hesitate to reach out! Email us anytime at  [**contact@globo.io**](mailto:contact@globo.io)**.**— we’re here to help with sincere support.


# Display options in Packing Slip

**🛠️ Approach #1: Using Shopify Order Printer**

## <mark style="color:blue;">Using Shopify Order Printer</mark>

Our **Product Options** app works with Shopify’s **Order Printer** app, so you can include custom option details right on your packing slips.

{% stepper %}
{% step %}
&#x20;From your **Shopify admin**, click on **Apps**

{% endstep %}

{% step %}
Select **Order Printer** from your app list

<figure><img src="/files/JYr6qPI0NtNdGXH9ACW3" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Manage Templates** > **Packing slip**

<figure><img src="/files/yVeGhtNfBPAbaRw7fDnF" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
**Download the packing slip template** *(*[*click this button to download*](https://github.com/globo-software/display-cart-line-item-in-notification/blob/main/gpo-packing-slip-template-order-printer.liquid)*)*
{% endstep %}

{% step %}
**Copy the code**&#x20;

```
 <div class="gpo-properties">
    {% assign property_size = line_item.properties | size %} 
    {% if property_size > 0 %} 
      {% for p in line_item.properties %} 
        <div class="gpo-property">
          {% assign first_character_in_key = p.first | truncate: 1, '' %}
          {% unless p.last == blank or first_character_in_key == '_' %} 
            <span>{{ p.first }}: </span>
            {%- if p.last contains '/uploads/' -%} 
              <a href="{{ p.last }}">{{ p.last | split: '/' | last }}</a> 
            {%- else -%} 
              <span>{{ p.last }}</span>
            {%- endif -%} 
          {% endunless %} 
        </div> 
      {% endfor %}
    {% endif %} 
  </div>
```

and **paste to Template Details** section

<figure><img src="/files/mLooNxzFipbxwiYFKpDm" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
**Save the change**

{% endstep %}
{% endstepper %}

## <mark style="color:blue;">Through Shopify Settings</mark>&#x20;

This method lets you directly update Shopify’s built-in packing slip template from your store’s settings.

{% stepper %}
{% step %}
From your **Shopify admin**, click on **Settings**
{% endstep %}

{% step %}
Go to **Shipping and Delivery**
{% endstep %}

{% step %}
Scroll down to the **Packing Slip Template** section

<figure><img src="/files/XXUrkABqkkxdDT9kUN08" alt=""><figcaption></figcaption></figure>

Click **Edit** next to the Packing Slip Template
{% endstep %}

{% step %}
**Download the packing slip template** *(*[*click this button to dowload*](https://github.com/globo-software/display-cart-line-item-in-notification/blob/main/gpo-packing-slip-template.liquid)*)*
{% endstep %}

{% step %}
**Copy the code**

```
  <div class="gpo-properties">
          {% assign property_size = line_item.properties | size %} 
          {% if property_size > 0 %} 
          {% for p in line_item.properties %} 
          <div class="gpo-property">
            {% assign first_character_in_key = p.first | truncate: 1, '' %}
            {% unless p.last == blank or first_character_in_key == '_' %} 
            <span>{{ p.first }}: </span>
            {%- if p.last contains '/uploads/' -%} 
            <a href="{{ p.last }}">{{ p.last | split: '/' | last }}</a> 
            {%- else -%} 
            {{ p.last }} 
            {%- endif -%} 
            {% endunless %} 
          </div> 
          {% endfor %}
          {% endif %} 
    </div>
```

&#x20;and Paste to **Edit Packing Slip Template** field

<figure><img src="/files/hpEGLpVYPWlnGzQzM5q4" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Save

{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**


# Display options in Confirmation Email

This is the email your customer receives right after placing an order. By default, Shopify’s order confirmation email doesn’t include custom option details — but you can change that!

> <mark style="color:orange;">🔔</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Note:**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">If you've already customized your email templates,</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**do not**</mark> <mark style="color:orange;"></mark><mark style="color:orange;">copy and paste the full code below. Instead, review and merge it carefully.</mark>

***

#### 📌 Follow These Steps:

{% stepper %}
{% step %}
From your **Shopify admin**, click on **Settings,** Select **Notifications**

<figure><img src="/files/MoWoj2nbomCc8ofRBlX6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Under **Customer Notifications**, click **Order confirmation**

<figure><img src="/files/ZtbjqtQcCXj41Nre5Zjb" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Download the Order Confirmation template** *(*[*click this button to download*](https://github.com/globo-software/display-cart-line-item-in-notification/blob/main/gpo-order-confirmation.liquid)*)*
{% endstep %}

{% step %}
**Copy the code**&#x20;

```
<div class="order-list__item-properties">
	{% assign property_size = line.properties | size %} 
	{% if property_size > 0 %} 
	{% for p in line.properties %} 
	<div class="order-list__item-property">
		{% assign first_character_in_key = p.first | truncate: 1, '' %}
		{% unless p.last == blank or first_character_in_key == '_' %} 
		<span>{{ p.first }}: </span>
		{%- if p.last contains '/uploads/' -%} 
		<a href="{{ p.last }}">{{ p.last | split: '/' | last }}</a> 
		{%- else -%} 
		{{ p.last }} 
		{%- endif -%} 
		{% endunless %} 
	</div> 
	{% endfor %}
	{% endif %} 
</div>
```

**and Paste to Email body (HTML)** box

<figure><img src="/files/zbC24ugst4tVBvUyJ5GZ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Save**
{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**


# Display option in Staff order notification

This is the email the **store owner or staff** receives when a customer places a new order. To include product option details, you can customize the notification template by following these steps:

{% stepper %}
{% step %}
From your **Shopify admin**, click **Settings,** Select **Notifications**

Scroll down to the **Staff Order Notifications** section

<figure><img src="/files/LLpe9T3KBneYiVWAajXP" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **New order**

<figure><img src="/files/GUx0EyzJEUoypjfpU7i6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Download the New Order template** *(*[*click this button to download*](https://github.com/globo-software/display-cart-line-item-in-notification/blob/main/gpo-new-order-notification.liquid)*)*
{% endstep %}

{% step %}
Open the downloaded file and **copy the code**&#x20;

```
 <div class="order-list__item-properties">
	{% assign property_size = line.properties | size %} 
	{% if property_size > 0 %} 
	{% for p in line.properties %} 
	<div class="order-list__item-property">
		{% assign first_character_in_key = p.first | truncate: 1, '' %}
		{% unless p.last == blank or first_character_in_key == '_' %} 
		<span>{{ p.first }}: </span>
		{%- if p.last contains '/uploads/' -%} 
		<a href="{{ p.last }}">{{ p.last | split: '/' | last }}</a> 
		{%- else -%} 
		{{ p.last }} 
		{%- endif -%} 
		{% endunless %} 
	</div> 
	{% endfor %}
	{% endif %} 
</div>
```

**and Paste to Email body (HTML)** box

<figure><img src="/files/2oUPQkD4l1D14HiBnllz" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Save**
{% endstep %}
{% endstepper %}

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**


# 🛍️ Shopify Point of Sale (POS) Integration

**🔗 Integration Overview**

The integration between **Globo Product Options** and **Shopify POS** helps streamline your business by allowing you to accept payments both online and in person. With this setup, you can accept:

💵 Cash\
💳 Credit/Debit Cards\
🎁 Gift Cards

Shopify POS is a user-friendly iPad app that lets you manage in-store sales. It can work independently or sync with your online Shopify store — letting you manage orders across mobile, in-store, and online from one place.

> 📝 **Note:** This POS integration feature is available only in the **latest version** of the Globo Product Options app. If you're still using **version 1**, please reach out to us at **<contact@globosoftware.net>** for support.

**For the detailed setup, you can refer to the instruction video here:** [**How to Set Up Shopify POS with Globo Product Options**](https://youtu.be/w9IGXU8B05k?si=FTakWcIkSG7iKh7G)

#### 🔧 How to Add Globo Product Options to Shopify POS

**📲 Steps:**

1. 🧩 On the POS **smart grid**, tap **Add tile**
2. 📱 Tap **App**
3. 🔍 Select **Globo Product Options**
4. 🌐 Tap **App Website**, then click the **Add** button
5. 💾 Tap **Save** to complete setup

<figure><img src="/files/7Xf3ekVrD5MRzmLhclCM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ZyhbIloqe9AwDclXVvuR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ihsQv825jA3dUUd7DCAf" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UlDWSvdwpXucACttocNS" alt=""><figcaption></figcaption></figure>

Now, you’re ready to use Globo Product Options directly in your POS system — making it easier to manage custom options at checkout, even in-store.

#### 🛒 Adding a Product to the Cart in Shopify POS

Adding a product to the cart is one of the core actions in any Point of Sale system. Here's a step-by-step guide to doing it using the **Globo Product Options** integration:

***

#### 📌 Step-by-Step Instructions

1. 🔍 **Search for the Product**\
   On the POS **Home screen**, use the **global search bar** at the top.
2. 💡 **Enter Search Terms**\
   Type a keyword such as the product name, variant, vendor, or any relevant info. Matching results will appear below.
3. ✅ **Select a Variant**\
   If the product has multiple variants, choose the one that's in stock at your current location. Then, **add it to the cart**.
4. 🧩 **Open Globo Product Options**\
   On the **Home screen**, tap the **Globo Product Options tile**.
5. ✏️ **Edit Options**\
   Tap **Edit Options** to add the product options (created in the app) to the cart.
   * The matching **Option Set** will appear.
   * Fill in all required fields.
   * If any add-on options are selected, they will automatically be added as additional products in the cart.
   * Once finished, tap **Close** (top left) to return to the Home screen.
6. 🛠️ **Use More Actions** (Optional)\
   On the Home screen, tap **More actions** to:
   * Add a customer 👤
   * Apply discounts 🎟️
   * Or perform other order-related tasks.
7. 🧾 **Review and Checkout**
   * Check that all **Line Item Properties** (option details) look correct in the cart summary.
   * Tap **Checkout**.
   * Choose from your enabled payment types (cash, card, gift card, etc.).

***

#### 🎬 Step-by-Step Video Tutorial

▶️ *Please refer to the* [*video*](https://www.youtube.com/watch?v=G01nr_6enmc) *below for a visual walkthrough.*

***

**📩 Need help?**\
If you run into any issues creating a new option set, don’t hesitate to reach out! Email us anytime at [**contact@globo.io**](mailto:contact@globo.io)**.**— we’re here to help with sincere support.<br>


# SA Request a Quote, Hide Price

**App Compatibility with “SA Request a Quote, Hide Price”**\
App URL: <https://apps.shopify.com/request-for-quote>

Our app works **partially** with the “Request a Quote” app. Please check the details below:

#### ❌ Not Compatible When:

* Your option set includes **add-on products**.
* You use **validation functions** in your option elements, such as:
  * Required fields
  * Max length for Text or Text Area fields
  * Min/Max value for Number fields
  * Min/Max selections for Checkbox or Swatch fields

#### ✅ Fully Compatible When:

* You are using a **normal option set** without any of the above conditions.

***

**📩 Need help?**\
If you run into any issues creating a new option set, don’t hesitate to reach out! Email us anytime at [**contact@globo.io**](mailto:contact@globo.io)**.** — we’re here to help with sincere support.


# Globo Pre-order App

**PreOrder Globo | Back in Stock**\
App URL: <https://apps.shopify.com/pre-order-pro>

Our app is **partially compatible** with the PreOrder Globo | Back in Stock app.\
There are some cases where both apps **cannot work together**:

#### ❌ Not Compatible When:

* You use the **Discount** or **Partial Payment** feature in the PreOrder app.
* Your option set includes **add-on products**.
* Your option elements use **validation functions**, such as:
  * Required fields
  * Max length for Text/Text Area fields
  * Min/Max values for Number fields
  * Min/Max selections for Checkbox or Swatch fields

***

**📩 Need help?**\
If you run into any issues creating a new option set, don’t hesitate to reach out! Email us anytime at [**contact@globo.io**](mailto:contact@globo.io)**.** — we’re here to help with sincere support.


# GemPages Landing Page Builder

**GemPages Landing Page Builder**

App URL: <https://apps.shopify.com/gempages>&#x20;

### 🧩 Integrate Globo App with GemPages

Follow these steps to add the Globo app element to your GemPages design:

***

#### **Step 1: Add Globo Element to GemPages** ➕

1. Open **GemPages Editor**.
2. Use the **search bar** to find the **Globo app element**.
3. **Drag and drop** the element onto your design area.
4. Click **Save**.

**Additional Setup:**

* Click on the **product element**.
* Choose **Display by assigned product**.
* Select your **desired product**.

<figure><img src="/files/6ykv43RPSLB6n03UfOhs" alt=""><figcaption></figcaption></figure>

***

#### **Step 2: Publish and Verify** 🚀

1. **Publish** the page in GemPages.
2. **Check your live page** to confirm the element is working.<br>

<figure><img src="/files/lviYKR5yFJilJWHGiOmj" alt=""><figcaption></figcaption></figure>

***

#### ⚡ Notes & Limitations

* Globo **does not support Preview Mode** in GemPages.
* The app **only works on product pages**.
* **Only one Globo element** is allowed per page.
* All **widgets and options** of the Globo app are **already integrated** into GemPages.

***

**📩 Need help?**\
If you run into any issues creating a new option set, don’t hesitate to reach out! Email us anytime at [**contact@globo.io**](mailto:contact@globo.io) — we’re here to help with sincere support.


# Automations Function

This functions allows creating a workflow for **Email notification, Order notes update, Order tags update.**

**📧 1. Email Notification**

When a customer places an order that includes **Globo options**, the system automatically sends a notification email.

* 🖼️ **Preview Template** – See a preview of the email content.
* ✏️ **Edit Template** – Customize the email from the **Edit Code** tab.
* 🌐 **Send From Your Domain** – Set up **Mail SMTP & API** to send from your own domain.

<figure><img src="/files/JqetRfnnPFQT5dM9W3at" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/V9xzI36ECXPT5NPjL6mA" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wZu7bNHZ8jgf4Gle147e" alt=""><figcaption></figcaption></figure>

**📝 2. Order Notes Update**

After an order is placed with Globo options, the app updates the **Order Notes** to reflect selected options.

* 🧩 **Customizable Content** – Use **Liquid variables** to personalize the note.
* 🔒 **Preserve Existing Notes** – Enable **“Keep existing order notes”** to **append** new info instead of overwriting.

<figure><img src="/files/wU5KiRAv5KF6VytNPjeh" alt=""><figcaption></figcaption></figure>

**🏷️ 3. Order Tags Update**

Automatically apply tags to orders based on Globo option selections.

* 📌 **General Tags** – Add a tag to all orders with any Globo option.
* 🎯 **Specific Tags** – Apply tags when specific elements or options are selected by the customer.

<figure><img src="/files/Xd4MQrLi50dwEA9CXQZH" alt=""><figcaption></figcaption></figure>

📧 **Need Help?**\
If you run into any issues while setting up your option set, feel free to reach out to us at **Chat** or email [**contact@globo.io**](mailto:contact@globo.io)**.**

We’re always here and happy to help — with sincerity and care!\
&#x20;


# Getting started

​GLO Color Swatch & Bundles is a Shopify app designed to enhance product displays by allowing merchants to present product options as image and color swatches, dropdowns, or button.

### Prerequisites <mark style="color:red;">\*</mark>

Before setting up color swatches, make sure:

* **Your products have variants** (e.g. Color: Red, Blue, Green; Size: X, M, L, XL).
* If newly added variants are not appearing, **sync your product data** in the GLO Color Swatch.

***

### [1. Product variants swatch](/product-variant-swatch/configure-swatch-style)

* Display product variants as color or image swatches on product pages, collection pages, homepages, and search results.
* Improve customer experience by allowing quick and easy selection of product options.
* Choose from different swatch types: color, image, or custom uploaded images.

<figure><img src="/files/ZckWKUtEThqWilmAqST6" alt=""><figcaption><p>Product variants swatch</p></figcaption></figure>

### [2. Group products as variants](/group-products-as-variants/configure-product-group-as-variant)

* Combine multiple single products into one parent product with selectable variants.
* Maintain separate inventory tracking for each grouped product while displaying them under one listing.
* Enhance store navigation and reduce clutter by consolidating similar products into one.

<figure><img src="/files/d2XayuJ0xzYDotA40dlN" alt=""><figcaption><p>Group products as variants</p></figcaption></figure>

### [3. Bundles product](/bundles/setting-up-product-bundles)

* Create product bundles (up to 5 items) to encourage customers to purchase complementary products together.
* Offer discounts or promotions on bundled products to increase average order value.
* Allow customers to customize their bundles by selecting specific variants within a bundle offer.

<figure><img src="/files/X09xMXCnCaV7ETunitth" alt=""><figcaption><p>Bundles product</p></figcaption></figure>

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Configure swatch style


# Choose swatch type

We offer various types to display variant options. You can choose from the options below to customize how the variants appear.

> The variant type will appear on both the collection page and the product page.&#x20;

### <mark style="color:red;">Prerequisites \*</mark>

Before setting up color swatches, make sure:

* **Your products have variants** (e.g. Color: Red, Blue, Green; Size: X, M, L, XL).
* If newly added variants are not appearing, **sync your product data** in the GLO Color Swatch.

<figure><img src="/files/BXCQQApgtZoGvpLdyXkC" alt=""><figcaption><p>Add variants for product</p></figcaption></figure>

## Choose swatch style

Go to the app **Options** tab -> Choose the swatch style you want in the "**Display as**" column.

<figure><img src="/files/JgWsWotSBmJSpUEzTE6j" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">1. Swatch</mark>

### **Color**

Choose colors to showcase your variants. This type allows you to display options using color swatches, making it easy for customers to pick their preferred color with just a click.

{% hint style="info" %}
Suitable for variations color.
{% endhint %}

<figure><img src="/files/rMJHUTGXhH78OIn0opsv" alt=""><figcaption><p>Swatch - Color</p></figcaption></figure>

### Image custom (file upload, link image)

Upload custom images for each variant, either through file upload or by linking images. This gives you the flexibility to show your variants visually, making it easier for customers to see exactly what they’re selecting.

{% hint style="info" %}
Suitable for products with common variations, similar variations will share the same image like material, sample code, sample series.
{% endhint %}

<figure><img src="/files/MqH72ubWvNfr2olhs2zs" alt="" width="188"><figcaption><p>Swatch - Image Custom</p></figcaption></figure>

### **Image automate (main image for selected variant)**

Automatically show the main image for the selected variant. When a customer chooses a variant, the image updates to reflect that option, helping them see exactly what they're getting.

{% hint style="info" %}
Suitable for almost all types of variants (like color, model, type, material,...)
{% endhint %}

<figure><img src="/files/qi9oGGrOvnil8aGRAvcN" alt=""><figcaption><p>Swatch - Image Automate</p></figcaption></figure>

## <mark style="color:blue;">**2. Button type**</mark>

Display variant options as clickable buttons. Customers can simply click a button to choose their desired variant, making the selection process fast and intuitive.

{% hint style="info" %}
Suitable for simple variants (like size, short text, type, material,...)
{% endhint %}

<figure><img src="/files/nxRrI1KuFzZeN8qaISTV" alt=""><figcaption><p>Button basic</p></figcaption></figure>

<figure><img src="/files/Zcxs1dDVgRroda6cQSar" alt=""><figcaption><p>Button without border</p></figcaption></figure>

<figure><img src="/files/vUM0GlvYFiXZClzDVXJF" alt=""><figcaption><p>Pill button</p></figcaption></figure>

## <mark style="color:blue;">**3.**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">Dropdown</mark>

Show the variant options in a dropdown list. This type is great for keeping things neat and organized, offering a clean way for customers to choose their options.

{% hint style="info" %}
This type is perfect for keeping your product page clean and organized, especially when you have many variants (like text, long text, many options). It’s ideal for products with multiple options that you want to present in a simple, easy-to-navigate format.
{% endhint %}

<figure><img src="/files/b3Xh2JB9wA8N0knWZXvz" alt=""><figcaption><p>Dropdown basic</p></figcaption></figure>

<figure><img src="/files/slxPD7ON40bD13RBAVci" alt=""><figcaption><p>Dropdown - Swatch Color</p></figcaption></figure>

<figure><img src="/files/BoelmHSadpfKwjX2UlC8" alt=""><figcaption><p>Dropdown - Swatch Image</p></figcaption></figure>

## <mark style="color:blue;">**4.**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">Variant with price</mark>

Display the variant options along with the price. This gives customers a clear view of the price for each variant, making it easy for them to make a decision based on their budget.

{% hint style="info" %}
Suitable for different price points for variant options.
{% endhint %}

<figure><img src="/files/RCp0K0jKwn1VmkCXdPVV" alt=""><figcaption><p>Variant with price basic</p></figcaption></figure>

<figure><img src="/files/EMxAsapgpWly4RqwdqR0" alt=""><figcaption><p>Variant with price - Swatch Color </p></figcaption></figure>

<figure><img src="/files/x52wO926wcfhObHhwBCk" alt=""><figcaption><p>Variant with price - Swatch Image </p></figcaption></figure>

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Set color HEX code for each value

Use color hex as swatch, you can setup up to 2 color codes for the same variant option value.

## Guide

### <mark style="color:blue;">Step 1. Choose variant(s) to be displayed as Swatch style</mark>

* Go to **the Options** section
* Select your product variations to display as swatches<br>

  <figure><img src="/files/v8ii6XpoVByPYcSxXM5O" alt=""><figcaption></figcaption></figure>

### <mark style="color:blue;">Step 2. Change display style to swatch</mark>

{% hint style="info" %}
List of styles that support HEX code:&#x20;

✅ Swatch

✅ Pill swatch

✅ Custom swatch with price

✅ Swatch dropdown
{% endhint %}

<figure><img src="/files/LWwtAtYXQ5ETUKKL028M" alt="" width="187"><figcaption><p>Swatch</p></figcaption></figure>

<figure><img src="/files/IoJaYr5F1DSlRCyb5jtu" alt="" width="197"><figcaption><p>Pill swatch</p></figcaption></figure>

<figure><img src="/files/O8n6yEqwbzgkKCniWPGe" alt="" width="170"><figcaption><p>Custom swatch with price</p></figcaption></figure>

<figure><img src="/files/iYbxi3vyZwBo6jKcwzk1" alt="" width="175"><figcaption><p>Swatch dropdown</p></figcaption></figure>

* From the **Display as** dropdown, choose **Swatch** style.

<figure><img src="/files/zUFYb4ZA069Z11KdcYiR" alt=""><figcaption></figcaption></figure>

* Click **Save** button to save the changes.

### <mark style="color:blue;">Step 3. Set HEX code for each color value</mark>

* Click the **Set Swatches** button

<figure><img src="/files/HAVGqMG6DyELdz9ZaECz" alt=""><figcaption></figcaption></figure>

* In the configuration page, you can setup HEX code for value.
* If you use 2 colors, you need to tick the **checkbox next to color 2**
* **Save** and preview the changes on the frontstore.<br>

<figure><img src="/files/VbYhelE00ns04KJu3vMJ" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">Result:</mark>

<figure><img src="/files/YFdCsT583KtLIIqeijBH" alt=""><figcaption><p>Demo</p></figcaption></figure>

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Use custom image for each value

### <mark style="color:blue;">Step 1. Choose variant(s) to be displayed as Swatch style</mark>

* Go to **the Options** section
* Select your product variations to display as swatches<br>

  <figure><img src="/files/v8ii6XpoVByPYcSxXM5O" alt=""><figcaption></figcaption></figure>

### <mark style="color:blue;">Step 2. Change display style to swatch</mark>

{% hint style="info" %}
List of styles that support custom image:&#x20;

✅ Swatch

✅ Pill swatch

✅ Custom swatch with price

✅ Swatch dropdown
{% endhint %}

* From the **Display as** dropdown, choose **Swatch** style.

<figure><img src="/files/zUFYb4ZA069Z11KdcYiR" alt=""><figcaption></figcaption></figure>

* Click **Save** button to save the changes.

### <mark style="color:blue;">Step 3. Upload a custom image for each color value</mark>

* Click the **Set Swatches** button

<figure><img src="/files/XB7EcENgsENCUhCQqHuM" alt=""><figcaption></figcaption></figure>

* Choose the **Image** option
* Upload a custom image or directly put the Image URL of the custom image
* Click **Save** to finish.

<figure><img src="/files/aGT9TOcCi6ogvHo1vjs4" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">Result:</mark>

<figure><img src="/files/wSmSOOuugHBYkWRxuEVx" alt=""><figcaption></figcaption></figure>

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Use image of product variant

## <mark style="color:red;">Prerequisites \*</mark>

* You need to add the main image for each variant of your products.

### Step 1 - Add image for each variant&#x20;

Go to the Shopify product detail -> Add image for each variant:

<figure><img src="/files/FOdAsV0y0R4C0TrDbna6" alt=""><figcaption><p>Add main image variants</p></figcaption></figure>

### Step 2. Sync data in GLO Color Swatch app

Go to the **Options** section, click the **Update data** button.

<figure><img src="/files/SdEZkaDXdGKxgQYBfIvX" alt=""><figcaption></figcaption></figure>

### Step 3. Change display style to Automated Swatch

{% hint style="info" %}
List of styles that support automatic variant image

✅ Automated swatch

✅ Image swatch with price

✅ Image dropdown
{% endhint %}

<figure><img src="/files/ncMpAUKTzNCuj4dEdn2d" alt="" width="302"><figcaption><p>Automated swatch</p></figcaption></figure>

<figure><img src="/files/HJLPaDOahgII8cgXU11X" alt="" width="255"><figcaption><p>Image swatch with price</p></figcaption></figure>

<figure><img src="/files/pXL6tk79VXrzY24qN60M" alt="" width="261"><figcaption><p>Image dropdown</p></figcaption></figure>

<br>

* Go to the **Options** section
* Select your product variations to display Variant image.
* From the **Display as** dropdown, choose **Automated Swatch** style.

<figure><img src="/files/H4cYOWnxCry0upbLwqFH" alt=""><figcaption></figcaption></figure>

### <mark style="color:blue;">Result:</mark>

<figure><img src="/files/6jyVUPr4vU60WYEJ6TMd" alt=""><figcaption><p>Demo </p></figcaption></figure>

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Display on product page


# Show only images related to the selected variant

This feature displays only the images associated with the selected variant, creating a more relevant and streamlined shopping experience for your customers.

When a variant group is selected, all images that do not belong to that group will be hidden, ensuring that customers only see images relevant to the selected variant.

<figure><img src="/files/ItsNmUJI1riGDkQbZzF3" alt=""><figcaption><p>Group image by color green</p></figcaption></figure>

<figure><img src="/files/FhDhiFNQBq0Q6wDRnuyc" alt=""><figcaption><p>Group image by color pink</p></figcaption></figure>

There are two ways to show only the images related to the selected variant:

**Option 1:** Use Shopify variant images by grouping product images.

**Option 2:** Assign images directly in the GLO Color Swatch app. This method gives you more flexibility and doesn't require rearranging your Shopify product images.

Choose the option that best fits your workflow.

| Method                 | Best for                                                                  |
| ---------------------- | ------------------------------------------------------------------------- |
| Shopify Variant Images | You already manage variant images in Shopify.                             |
| Assign Images in Globo | You want to control image groups without changing Shopify product images. |

Choose the method that best fits your store.

## Method 1 - Arrange existing **Shopify Variant Images**

Before you begin, make sure:

* Each color or model has its own set of product images.
* Images are uploaded to the Shopify product.

{% stepper %}
{% step %} <mark style="color:blue;">Group image thumbnails by color</mark>

In the Shopify Products admin, arrange your product images so that images belonging to the same variant are placed together.

Example:

White 1 → White 2 → White 3

Pink 1 → Pink 2 → Pink 3

Black 1 → Black 2 → Black 3

<figure><img src="/files/bFnAO0hnoxALc6AswRpH" alt=""><figcaption><p>Group image thumbnails</p></figcaption></figure>

<figure><img src="/files/1XsyaPUcRihBt66XP9eH" alt=""><figcaption><p>Group image thumbnails</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">Sort variants and group by color</mark>

* Once the image group is complete, scroll down to the variation options
* Reorder variants, **variant option displayed as image or color must be placed on top**

<figure><img src="/files/aQycMIVuOrkIKooB9UAV" alt=""><figcaption><p>Sort variants and group by color</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">Select image for main variant</mark>&#x20;

<mark style="color:red;">**The image assigned as the variant's main image in Shopify must be the first image in its image group.**</mark>

<figure><img src="/files/EXsi1lpkbL61Qld4HmOx" alt=""><figcaption><p>Select image for main variant</p></figcaption></figure>

<figure><img src="/files/M01ZZqIpSdoe9yujxLFH" alt=""><figcaption><p>Select image for main variant</p></figcaption></figure>

<mark style="color:red;">**Make sure all primary image variations in a group are the first image of a group.**</mark>

<figure><img src="/files/XkcCxiy5dKJJvfMrBEMo" alt=""><figcaption><p>Select image for main variant</p></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">Sync data in the GLO Color Swatch app</mark>

If you've recently updated product images or variants in Shopify, click **Update Data** to synchronize the latest changes with the app.

<figure><img src="/files/w8tLCsXIpzy87HIlsZjX" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">Set Color/Image display style for variant</mark>

To use this feature, your variant option must be displayed as a **Color Swatch** or **Image Swatch**. Variant types such as **Dropdown** and **Button** do not support image grouping.

{% hint style="info" %}
List of styles that support group image function:&#x20;

✅ Swatch

✅ Pill swatch

✅ Automated swatch

✅ Image swatch with price

✅ Custom swatch with price

✅ Swatch dropdown

✅ Image dropdown

❌ Button (all style button)

❌ Button with price (basic)

❌ Dropdown  (basic)
{% endhint %}

<figure><img src="/files/x0Xy3ohBqSQV2X2JaxyZ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">Enable the Group image function</mark>

* Navigate to the **Settings** section
* Check on the **Group image** checkbox
* **Select a Shopify theme** that you're using on your store.
* Click **Save** to finish.

<figure><img src="/files/YCGvV40a04f6Jan61Q1O" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %} <mark style="color:blue;">Video guide</mark>

{% embed url="<https://www.youtube.com/watch?v=P5HZbJIKGJ4>" %}
Video guide
{% endembed %}
{% endstep %}
{% endstepper %}

## Method 2 - Assign Images in the GLO Color Swatch App (New)

If you need more control over which images are displayed for each variant, you can assign images directly in the Globo app instead of relying on Shopify's variant images.

### Steps to assign images

1. Open the product in **GLO Color Swatch**.
2. Go to **Assign Images**.
3. Select a product.<br>

   <figure><img src="/files/Ip2aKKfc9gK17vjMz3Ef" alt=""><figcaption></figcaption></figure>
4. Choose the images that should be displayed for a specific variant.<br>

   <figure><img src="/files/3geFZMvgHG8qR2I14hby" alt=""><figcaption></figcaption></figure>
5. Save your changes.
6. Set color/image display style for variant<br>

   <figure><img src="/files/xaqLGQkLZ47c6xUBbPSR" alt=""><figcaption></figcaption></figure>
7. Enable the **Group image** function.<br>

   <figure><img src="/files/44zQWrT8Jin7TbPlQDcS" alt=""><figcaption></figcaption></figure>

👉 *Watch the video tutorial:*&#x20;

{% embed url="<https://www.youtube.com/watch?v=0ryx-rw2IH0>" %}

### Assign a general image to multiple variants

If you have an image that should be displayed for **every variant** (such as a size chart, product packaging, a lifestyle photo, or a brand image), you only need to upload it once.

Any image left in the **Shared across all variants** section will be displayed regardless of which variant the customer selects.

#### **How to set up**

1. Go to the **Assign Images** section.
2. Open the product you want to adjust.
3. Leave the general image in the **Shared across all variants** section. **Do not assign it to any specific variant.**
4. Click **Save**

<figure><img src="/files/HBx9GlJPz2zPJwPR4ugp" alt=""><figcaption></figcaption></figure>

#### How It Works

When a customer selects a different variant:

* Variant-specific images will change based on the selected variant.
* Images in the **Shared across all variants** section will remain visible for every variant.

This is useful for images that are not tied to a specific variant, such as:

* Size charts
* Product packaging
* Lifestyle photos
* Brand or promotional images
* Care instructions

> **Tip:** You can combine shared images with variant-specific images. Each variant will display its own assigned images together with any images in the **Shared across all variants** section.

***

## Troubleshooting

<mark style="color:blue;">1. Check your Theme Customize settings:</mark>

Some themes include a built-in feature called **"Hide other variants’ media after selecting a variant."**

If you're using the app's **Group Images** feature, please go to **Online Store → Themes → Customize** and disable this theme setting.

The theme's media filtering feature may conflict with the app's Group Images functionality, which can prevent images from displaying correctly.

<figure><img src="/files/sZzPcz4esdL5lzwymxP1" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">2. Still not working?</mark>

Please check:

* ✅ App Embed is enabled.
* ✅ Product data has been synced.
* ✅ The variant is displayed as a supported swatch type.
* ✅ Images are grouped correctly.
* ✅ Your theme's "Hide other variants' media" setting is disabled.

Some newer theme versions may not support this feature yet. If you've followed the setup instructions and it's still not working, please contact our support team for assistance.

For further help, reach out to us at <contact@globo.io>.


# Require to select options before adding to cart

This prevents incomplete orders and improves the shopping experience by required users to select all required options before click add to cart button.

<figure><img src="/files/lnplZ35DB2SLfASHpcTq" alt=""><figcaption><p>Demo</p></figcaption></figure>

<mark style="color:blue;">Step 1: Enable Globo Color Swatch on the product detail page</mark>

* Open the **GLO Color Swatch** app from your Shopify admin panel.
* Navigate to the **Settings** section.
* Enable the **Swatch on Product Page** option to activate swatches on product pages.

<figure><img src="/files/urMuife1BEBYZ4sT2SJR" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">Step 2. Enable required swatch options and setup the required messages</mark>

<figure><img src="/files/8JWIrMwCS9BIkEwJMKVj" alt=""><figcaption></figcaption></figure>

***

## Not work?

Most themes are already fully compatible with our app. If you're experiencing any issues with your theme, feel free to contact us at <contact@globo.io>, and we'll be happy to assist with the integration.


# Inventory alert on product detail page

Inventory alert function allows customer to see which product variants are currently available for purchase. It helps streamline the shopping experience by displaying real-time inventory status.

## Demo

<figure><img src="/files/4KQdJppVVYwOyN0CuMPA" alt=""><figcaption><p>Demo</p></figcaption></figure>

## Step-by-step configurations

Display real-time stock quantity messages on your product pages to create urgency and keep customers informed. Follow this step-by-step guide to set it up in your store.

1. Navigate to the appearance page.
2. Click the set up button

In the Appearance list, you can select any style and click **Set Up**. The In Stock product message settings will be applied across all appearance types, so there's no need to configure each one separately.

<figure><img src="/files/xYxIHaN8u46NhUH5p21b" alt=""><figcaption></figcaption></figure>

3. In the **On product page** tab, scroll to the bottom to enable this function.

<figure><img src="/files/CQdap2QYdd0n16OXyCzr" alt=""><figcaption></figcaption></figure>

* You can change the in-stock message here.
* Use the variable `{number}`  to display the current stock quantity of variant selected

> This function works only on product page, not collection page.&#x20;

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Change swatch position on product detail page

You can easily move the swatches to any position on your product page using Shopify's theme editor.

### Steps by steps

1. In Shopify Admin, go to **Online Store → Themes → Customize**.
2. Open a product page template.
3. In the left sidebar, find the **Variant Swatches** app block.
4. Drag and drop the block to your preferred position.
5. Click **Save**.

{% hint style="info" %}
You can use the application block to move to the position you want.
{% endhint %}

> #### <mark style="color:red;">Required\* :</mark>
>
> * The theme's default **Variant Picker** block must remain on the product page for variant selection and Add to Cart functionality to work properly.
> * You can move the app block anywhere within the product information section.
> * If you would like to hide the theme's default variant picker and display only the app's swatches, please contact our support team at [**contact@globo.io**](mailto:contact@globo.io) for assistance.

<figure><img src="/files/RITt0yo8ndNYZ35TpwRU" alt=""><figcaption><p>Add block variant swatchs</p></figcaption></figure>

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Display on collection page, home page & other pages


# Show add to cart button on product list

With this feature, you can display the Add to Cart button directly on product cards, allowing customers to add products to their cart without having to visit the product page first.

## Demo

<figure><img src="/files/32fov0AGZFTEl9YkPNQA" alt=""><figcaption><p>Demo</p></figcaption></figure>

## Guide

<mark style="color:blue;">Step 1. Enable GLO Color Swatch on the collection page</mark>

To use this feature, please make sure the swatches are enabled on your collection pages through the app settings.

<figure><img src="/files/7g674wnwo2M7rcGffWvA" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">Step 2. Enable the show add to cart button option below.</mark>

<figure><img src="/files/7PGy8wdIMztJ15B8VLhG" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">Step 3. Adjust button texts (optional)</mark>

* **Available label:** Displayed when the selected variant is available for purchase.
* **Added to Cart label:** Displayed when the selected variant has already been added to the cart.
* **Out of Stock label:** Displayed when the selected variant is unavailable or out of stock.

<mark style="color:blue;">Step 4. Enable Ajax Add to cart (optional)</mark>&#x20;

**Default:** When customers click **Add to Cart**, they will be redirected to the cart page.

**Enabled:** Allows customers to add products to their cart without leaving the current page.

**Choose Theme:** Only the themes listed in the dropdown support the Ajax **Add to Cart** feature with a cart drawer or popup cart. For other themes, products will still be added to the cart via Ajax, but the cart drawer or popup may not open automatically.

<figure><img src="/files/7jF90vayUCnmco3bld0U" alt=""><figcaption></figcaption></figure>

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Hide variant option on collection page

If your products have multiple variant options, displaying all of them on collection pages can make product cards look crowded and difficult to browse.

With the GLO Color Swatch app, you can choose which variant options to display and hide the rest.

### Example

A product has the following options:

* Color: Red, Blue, Black
* Size: S, M, L, XL

On collection pages, customers usually only need to see the Color options. You can hide the Size options to create a cleaner shopping experience.

### How to Set Up

1. Open the **GLO Color Swatch** app.
2. Go to the **Options** section.
3. Select the option you want to hide.
4. Disable **Show on Collection Page**.
5. Click **Save**.

<figure><img src="/files/khuunhEKOxSthaksCatW" alt=""><figcaption></figcaption></figure>

### Result

Only the selected variant options will be displayed on collection pages, making product cards cleaner and easier to navigate.

<mark style="color:purple;">E.g: We have size and color options:</mark>

<figure><img src="/files/LwwiC5U9OSBTJyoOHY8H" alt="" width="563"><figcaption><p>Before turn off variant size </p></figcaption></figure>

<figure><img src="/files/80V9gF4XaBJwHNPQJFY1" alt="" width="563"><figcaption><p>After turn off variant size</p></figcaption></figure>

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Enable carousel style for options on collection page

If your products have many variant values, displaying all of them on collection pages may take up too much space.

The Carousel feature allows customers to scroll through variant options while keeping product cards clean and organized.

### How to Set Up

1. Open the **Appearance** page in the app.
2. Select any swatch style and click **Set Up**.

   > Note: Carousel settings apply to all swatch styles on collection pages - except dropdown style.
3. Open the **On Collection Page** tab.
4. Enable **Carousel**.
5. Click **Save**.

<figure><img src="/files/P0OK9uqPJfCdzwv41oKU" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/waCdGZqPFfBFPiI3hxet" alt=""><figcaption></figcaption></figure>

### <mark style="color:purple;">Result</mark>

Variant options will be displayed in a scrollable row, helping you save space and maintain a cleaner collection page layout.

<figure><img src="/files/QfBtbsWHpYI5vTWIJYzZ" alt="" width="563"><figcaption><p>Before enable carousel on collection page</p></figcaption></figure>

<figure><img src="/files/BDOhbv9w0QxZxVMHoO7r" alt="" width="563"><figcaption><p>After enable carousel on collection page</p></figcaption></figure>

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Limit number of swatches displayed on Collection Page

If your products have a large number of variant options, displaying all of them on collection pages can make product cards look crowded.

In addition to using the Carousel feature, you can limit the number of swatches displayed for each product.

### How to Set Up

1. Open the **GLO Color Swatch** app.
2. Go to the **Settings** page.
3. Enable **Limit Swatches on Collection Page**.
4. Enter the maximum number of swatches to display on **desktop**.
5. Enter the maximum number of swatches to display on **mobile devices**.
6. Click **Save**.

<figure><img src="/files/tPVzDfBorYlwWjEMlOdH" alt=""><figcaption></figcaption></figure>

### Result

Only the specified number of swatches will be displayed on collection pages, helping keep your product cards clean and organized, especially for products with many variant options.

<figure><img src="/files/u15OvDVtyBU5hth8Lvx9" alt=""><figcaption></figcaption></figure>

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Display real-time product data as variations change

On the collection page we can show a preview of the selected variant including:

✅ Product title - variant name

✅ Product price of the current variant

✅ Main image product of the current variant

✅ URL product with variant

✅ Dynamic variant image

❌ Second image product of the current variant (no)

## **Benefits**

* **Instant image updates:** Variant images change immediately through the app’s dynamic JavaScript feature, ensuring smooth and responsive performance without reloading the page.
* **Higher engagement:** Shoppers can explore multiple product options directly on the collection page with just one click.
* **Enhanced user experience (UX):** Customers can easily visualize the exact product variant they’re interested in without navigating to the product page.
* **Better conversion rate:** Fewer steps and a faster preview process encourage shoppers to add products to their cart more quickly.

***

## Quick setup dynamic swatch

{% stepper %}
{% step %}

### <mark style="color:blue;">Go to the Shopify admin product detail</mark>

#### Add multiple variants option variant

<mark style="color:purple;">E.g: Color: White, Pink, Black, Green</mark>

<figure><img src="/files/KXoOZraSmAPpUYtBj5Cl" alt=""><figcaption><p>Add variant color/model</p></figcaption></figure>

#### Sort group variant by color/model

The variant displayed as a color/image must appear before the variant displayed as a button

<figure><img src="/files/HUt6Y4Fbacdk8EQZzxSb" alt=""><figcaption><p>Sort group variant</p></figcaption></figure>

#### Add main image for variant group

<figure><img src="/files/FOdAsV0y0R4C0TrDbna6" alt=""><figcaption><p>Add main image variants</p></figcaption></figure>

#### Save product

{% endstep %}

{% step %}

### <mark style="color:blue;">Sync data again in GLO Color Swatch</mark>

Go to **Dashboard** GLO Color Swatch, click **Update data button**

<figure><img src="/files/aYN1WDnUZ3sU7ZPSEzfN" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:blue;">**Setup option displayed as type color swatch or image**</mark>&#x20;

1. In **options list,** find your variant of product&#x20;
2. Setup type variant is in the types:&#x20;

```
✅ Swatch
✅ Pill swatch
✅ Automated swatch
✅ Image swatch with price
✅ Custom swatch with price
✅ Swatch dropdown
✅ Image dropdown
```

<figure><img src="/files/x0Xy3ohBqSQV2X2JaxyZ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:blue;">Enable variant show on collection and save</mark>

In **options list,** enable your option vairant show on collection page and save

<figure><img src="/files/khuunhEKOxSthaksCatW" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:blue;">Enable "Dynamic swatch" option</mark>

Go to **Settings** page, enable **dynamic swatch** function on collection, and **save.**

<figure><img src="/files/odwTduULugTMUtCOdCBt" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:blue;">Demo</mark>

<figure><img src="/files/jwmaxhyB9C072dN6lXxY" alt=""><figcaption><p>Before click variant image</p></figcaption></figure>

<figure><img src="/files/jPgG43bFwejYVvM1GkdV" alt=""><figcaption><p>After click variant image</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## **Dynamic variant image**

**🎯 Benefits**

* Provides a **seamless and intuitive shopping experience** — customers always see the correct images and prices for their selected variants.
* Reduces confusion when browsing products with multiple options.
* Automatically synchronizes all variant displays without requiring page reloads or manual selection.

{% hint style="info" %}
How it work?

* When the user clicks on a variant, the main product image will automatically switch to the image corresponding to that variant.
* For example: When the user selects the “Red” color and the “Swimsuit” style, the product image instantly changes to display the Red Swimsuit.
  {% endhint %}

{% stepper %}
{% step %}

### <mark style="color:blue;">Setting</mark>

* In setting page -> enable **dynamic variant image**

<figure><img src="/files/lAHy0v36NnWveXDV7kEw" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:blue;">Setup combine variant with multiple image & price</mark>

* example:

<figure><img src="/files/FcNlNm5VYFZ8cur15hQb" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:blue;">How it work</mark>

This feature ensures that **images, prices, and variant options** are automatically synchronized when customers select different options such as *Color*, *Style Sport*, or *Size* on the product page.

**🔹 Example Scenario**

Suppose a product has three variant groups:

* **Color:** Red, Blue
* **Style Sport:** Bikini, Swimm
* **Size:** X, S, M, L

**🔹 Behavior**

1. **When a customer selects a Color:**
   * The product image updates to **reflect the selected color** (e.g., choosing “Red” shows the red product image).
   * The *Style Sport* options (*Bikini* and *Swim*) will **display images** corresponding to the selected color.
   * If *Style Sport* is displayed as a “swatch with price,” the **price** of each style will **update automatically** based on the selected color.
   * The *Size* options will only show **sizes available** for that color.\
     If *Size* is displayed as “button with price,” the **price for each size** will also **update** accordingly.
2. **When a customer selects a Style Sport:**
   * The images for each color (*Red* and *Blue*) will automatically **update** to display the selected style (e.g., selecting *Bikini* shows both red and blue Bikini images).
     {% endstep %}

{% step %}

### <mark style="color:blue;">Demo</mark>

* Try it on [demo site](https://nga-appstore.myshopify.com/collections/dynamic-variant-image)&#x20;

<figure><img src="/files/EhBDnzIbCpBAaHmd23ll" alt=""><figcaption><p>Demo</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Advanced setting variants swatch

The advanced editing style variations feature allows you to fine-tune the appearance of their product swatches to match their store’s branding and user experience preferences.

## [1. Show/hide variant name](/product-variant-swatch/advanced-setting-variants-swatch/show-hide-variant-name)

<figure><img src="/files/bsouWtFnHYe86uW0ox0U" alt="" width="314"><figcaption></figcaption></figure>

## [2. Show/hide tooltip](/product-variant-swatch/advanced-setting-variants-swatch/show-hide-tooltip)

<figure><img src="/files/5EiqrBVSQgMkStEif0E3" alt="" width="284"><figcaption></figcaption></figure>

## [3. Out of stock style](/product-variant-swatch/advanced-setting-variants-swatch/configure-out-of-stock-style-for-variants)

<figure><img src="/files/FWB8g0nWhFDVtSBgCEz4" alt="" width="322"><figcaption></figcaption></figure>

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Show/hide variant name

In GLO Color Swatch, you can choose to **show** or **hide** the variant name (like size or color) on product pages:

* **Show Variant Name**: Displays the label (e.g., "Size: Medium" or "Color: Red") next to the variant options.
* **Hide Variant Name**: No label variant display

If you need customize to show only name or display only value selected in label vairant -> contact us to customize.

## 1. Show/hide variant name in product page

* Currently we always display variant name on product page, if you want to hide it please contact support team

## 2. Show/hide variant name in collection page

* In admin **GLOBO Color Swatch**, navigate to **setting page**
* Find box **Swatch on collection page**
* Enable or disable **show option name**
* **Save** setting

<figure><img src="/files/pGMpwJuTxsr8nFhqhwNp" alt=""><figcaption></figcaption></figure>

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Show/hide tooltip

Tooltips help customers identify variant options by displaying the variant name when they hover over a swatch.

{% hint style="info" %}

1. Setting tooltip will be apply for all variant swatch and in all page
2. If you want to turn off/on tooltip only on collection or product page, please contact us to customize
3. If you want to enable tooltip only with variant showing as color/image, other variants don't show tooltip, don't worry, we can customize it
   {% endhint %}

### How to Set Up

1. Open the **GLO Color Swatch** app.
2. Navigate to the **Settings** page.
3. Enable or disable **Show Tooltip on Hover** as needed.
4. Click **Save** to apply your changes.

<figure><img src="/files/pFmbPXrfE14KrAWopp1Z" alt=""><figcaption></figcaption></figure>

### Result

When enabled, customers will see the variant name in a tooltip when hovering over a swatch. When disabled, tooltips will not be displayed.

<figure><img src="/files/4WfaNH7l5WfasABay11C" alt=""><figcaption></figcaption></figure>

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Configure Out-of-stock style for variants

This helps shoppers quickly identify which options are available and which are out of stock.

## Available Styles

#### 1 - Show All Options

Display all variant options, including out-of-stock variants.

Customers can still see unavailable options, which may help them understand the full range of available products.

#### 2 - Cross Out Option

Out-of-stock variants remain visible but are displayed with a strikethrough effect.

#### 3 - Grey Out Option

Out-of-stock variants remain visible but appear faded or disabled.

#### 4 - Hide Options

Completely hide out-of-stock variants from customers.

Only available options will be displayed.

***

## How to Set Up

1. Open the **GLO Color Swatch** app.
2. Navigate to the **Settings** page.
3. From the **Out-of-Stock display** setting, select the display style you want to use.
4. Click **Save** to apply your changes.

<figure><img src="/files/28ocn0bvklU2FzFL2I5v" alt=""><figcaption></figcaption></figure>

## **How it work? see** out of stock example below

{% stepper %}
{% step %} <mark style="color:purple;">Your product have only one variant</mark>

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td align="center"><strong>All option sold out</strong></td><td><a href="/files/tYwOwF5SUtr52b3GkhFL">/files/tYwOwF5SUtr52b3GkhFL</a></td></tr><tr><td align="center"><strong>1 option sold out</strong></td><td><a href="/files/Yf5neJYECIqeclciZovC">/files/Yf5neJYECIqeclciZovC</a></td></tr></tbody></table>

{% endstep %}

{% step %} <mark style="color:purple;">Your product have 2 or more variants</mark>

**Sold-out status is applied to each specific variant combination (e.g., color + size).**

* **When a customer selects a color**, Shopify will show the "sold out" status for the sizes that are not available for that color.
* **When a customer selects a size first**, the "sold out" status will not automatically apply to the colors, only showing the colors that still have that size available.

**In short, the "sold out" status only applies to each specific combination (color + size) and doesn't work in reverse.** When a customer selects an option (color or size), Shopify will only show the available options for that choice and will not "sold out" the other options.

* All combination is sold out<br>

  <figure><img src="/files/9vEDpenNhPjVnoFFX9NX" alt=""><figcaption></figcaption></figure>
* **Black** have some size is sold out&#x20;

<figure><img src="/files/XVM0LgL02i7XyihEQr8B" alt=""><figcaption></figcaption></figure>

* All size combination sold out with **green** and **gray colors**

<figure><img src="/files/3MjgwuKcijYXjsFnnJdV" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## **Out of stock not correct in collection page?**

* You need to check if you are hiding any specific variant on collection page.

<figure><img src="/files/cwfmpvEqpLznlbRV67Au" alt=""><figcaption></figcaption></figure>

<mark style="color:purple;">Example:</mark>&#x20;

* Your product has 2 variations: color, size
* Color: White, Pink, Black, Green, Gray
* Size: S, M, L, XL, XXL

**How it works**:

* Let's say you have a **Pink** product, with size S out of stock, but sizes M and L are available. If you turn off the size option on the collection page, the stock will be calculated based on the **first size (S)**.
* Since size S is out of stock, the **Pink** color will show as "out of stock," even though it’s available in other sizes (M, L).

In short, when you turn off the size option on the collection page, the system will calculate stock based on the first size (S), and if that size is out of stock, the entire color will be marked as out of stock, even if other sizes are available.

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Control image swatch dimensions

Control the shape of image swatches displayed on your storefront.

By adjusting the ratio, you can make image swatches appear as squares, portraits, landscapes, or match the aspect ratio.

***

## **Set up**

{% stepper %}
{% step %}

### <mark style="color:blue;">Navigate to the settings page</mark>

In the **GLO Color Swatch**, navigate to the **Settings page > Image swatch**

<figure><img src="/files/xY0MvOy5Jf4hWUYlHCuX" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:blue;">Default size for image file</mark>

* The smaller the width and height, the faster the image loads.
* On the contrary, the larger the width and height of the image, the slower its display speed.
* By default, we set it to **150px**; you can adjust it to suit your needs.

<figure><img src="/files/DPOjpHSIajgXkpIdEHeE" alt=""><figcaption><p>Setting default width &#x26; height of image </p></figcaption></figure>

<mark style="color:purple;">Example 1:</mark>

If your image swatches are displayed at **35 × 35 px** on the storefront:

* Set the image swatch size to **35 × 35 px**.
* If the image appears blurry, try increasing it to **50 - 60 px**.

Using a size close to the displayed dimensions can significantly improve page performance, reducing image load time compared to using the default size of 150 px.

<mark style="color:purple;">Example 2:</mark>

If your image swatches are displayed at **300 × 300 px** on the storefront:

* Set the image swatch size to **300 × 300 px**.

If you keep the image size at **150 px**, the image will be stretched to fill the larger display area, which may result in a blurry or pixelated appearance.
{% endstep %}

{% step %}

### <mark style="color:blue;">Background size options</mark>

You can control how images fit within the swatch area by adjusting the **Background Size** setting.

#### Cover

The image fills the entire swatch area.

* May crop parts of the image.
* Best for creating a uniform appearance.

#### Contain

The entire image is displayed within the swatch area.

* No cropping occurs.
* May leave empty space around the image.

Choose the option that best matches your image style and store design.

<mark style="color:purple;">Example image background-size:</mark>

<figure><img src="/files/YclNcYtsHOj9fpnjRh5G" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:blue;">Save your work</mark>

{% endstep %}
{% endstepper %}

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Bulk export & import variant options

The **Export and Import** feature allows you to manage multiple variant options at once using a CSV file.

This is especially useful when:

* Updating a large number of color swatches or image swatches.
* Migrating settings between stores.
* Making bulk changes more quickly than editing options one by one.

## <mark style="color:red;">Prerequisites \*</mark>

You need to sync data before performing the export/import process.<br>

<figure><img src="/files/7dFllXs7bQATzuBaKCAw" alt=""><figcaption></figcaption></figure>

***

### How to Export

1. Open the **GLO Color Swatch** app.
2. Go to the **Options** page.
3. Choose the product option you want to export > Click **Set Swatches** button.
4. Click the **Export** butto&#x6E;**.**

<figure><img src="/files/YmoYSpOfUtr9u50JK4jY" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bcZXvcYrWenMJlXlcx84" alt=""><figcaption></figcaption></figure>

The exported file contains your current variant option configurations and can be edited in spreadsheet software such as Excel or Google Sheets.

<figure><img src="/files/YR8UQJjAT5wxbhlQlPL7" alt="" width="375"><figcaption><p>Data in excel tool</p></figcaption></figure>

### CSV Column Explanation

**Value**\
The name of the variant option value, such as **Red**, **Blue**, or **Large**.

**Select Type**\
Determines the type of data being imported for the variant option.

**Custom**\
The custom value associated with the selected type, such as:

* A color code (e.g., `#FF0000`)
* An image URL
* Other custom swatch data depending on the selected type

**Important**

* Do **not** edit the **Value** column. This column must match your Shopify variant option values exactly.
* If you want to leave a value blank, set:
  * **Select Type** = `One color`
  * **Custom** = `transparent`

{% hint style="info" %}
The **Select Type** column supports the following values only:\
**"One color"**\
**"Two color"** \
**"Upload file"**\
**"Image url"**
{% endhint %}

#### <mark style="color:$primary;">One Color</mark>

Use this option to display a single color swatch.

* Set **Select Type** to `One color`.
* Enter a color code in the **Custom** column.

We recommend using **HEX color codes** for the most accurate color representation.

**Example**

| Value | Select Type | Custom  |
| ----- | ----------- | ------- |
| Black | One color   | #000000 |

<br>

<figure><img src="/files/8ArHn0tPlWPrIRrbMikD" alt="" width="563"><figcaption><p>One color</p></figcaption></figure>

#### <mark style="color:$primary;">Two Colors</mark>

Use this option to display a swatch with two colors.

* Set **Select Type** to `Two color`.
* Enter the first color code in the **Custom** column.
* Enter the second color code in the next color column.

**Example**

| Value       | Select Type | Color 1 | Color 2 |
| ----------- | ----------- | ------- | ------- |
| Black/White | Two color   | #000000 | #FFFFFF |

<figure><img src="/files/ecIIGp4v6cwq6MSe5pVQ" alt="" width="563"><figcaption><p>Type two color</p></figcaption></figure>

#### Upload File

Use this option when the swatch image has already been uploaded to Shopify.

* Set **Select Type** to `Upload file`.
* Enter the image URL in the **Custom** column.

**Example**

<figure><img src="/files/u4iSwkjfgESCQ3stcMmN" alt=""><figcaption><p>Type upload image</p></figcaption></figure>

<figure><img src="/files/kpaB8Y2JOcK7AslOwDeh" alt=""><figcaption><p>Type image url</p></figcaption></figure>

### <mark style="color:blue;">How to Import</mark>

* Go back to the **GLO Color Swatch** app
* Open the **Options** page.
* Choose the product option you want to export > Click the **Set Swatches** button.
* Click **Import**.
* Upload your CSV file.
* Tick on the **Override all items** box if you need to replace the old value
* Click **Import** to apply the changes.
* Click to **overwrite** all items if you need to replace the old value
* Click **Save** to finish.<br>

  <figure><img src="/files/TPWIT8CIN4zD7qKPl34C" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** The import feature only updates existing variant values. It does not create new variants or add new option values to your products.
{% endhint %}

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Configure product group as variant

## **What is Product Group?**

**Group Products as Variants** allows you to link separate Shopify products together and display them as variant options on your storefront.

Instead of using Shopify's built-in variant system, you can connect individual products and let customers switch between them using color swatches, image swatches, buttons, or dropdown menus.

#### Give Each Product Its Own URL

Because each option is a separate Shopify product, every product keeps its own unique URL.

This can improve search engine visibility and allow each product to be indexed individually by Google.

#### Example

Instead of creating one product with multiple color variants:

* T-Shirt - Black
* T-Shirt - Blue
* T-Shirt - Red

You can create each color as a separate Shopify product and link them together using **Group Products as Variants**. Customers can then switch between colors just like they would with regular variants.

## Step-by-step configuration

{% stepper %}
{% step %}

### <mark style="color:blue;">Create a Product Group</mark>

1. Open the **GLO Color Swatch** app.
2. Go to the **Product Groups** page.
3. Click **Add Product Group button**.

A new group will be created where you can add related products.

<figure><img src="/files/TGu3cR7654FUeHtfU5Z7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### <mark style="color:blue;">Add products to the group</mark>

1. Enter a name for the group.
2. Enter the option name for this group. This name will appear on the product page.
3. In the Add Product section, click the **Browse** button
4. Select all products that belong to the same product family.
5. Save your changes.

<figure><img src="/files/3InDBgTrHAWCuPcrQJxD" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
We suggest you use the common name of the products in the product group as the name for this group.

Example:

* Brow Shaping - Gel
* Brow Shaping - Mascara
* Brow Shaping - Pencil

⇒ Group name is "Brow Shaping". \
This is a way to use names to make it easier to manage product groups later.
{% endhint %}
{% endstep %}

{% step %}

### <mark style="color:blue;">Configure display types</mark>

Choose how grouped products will be displayed on your storefront.

Available display types include:

* Color Swatches
* Image Swatches
* Buttons
* Dropdown Menus

Select the option that best matches your store design and product type.
{% endstep %}

{% step %}

### <mark style="color:blue;">Assign display values</mark>

For each product in the group, configure the value that customers will see.

#### Examples

| Product         | Display Value |
| --------------- | ------------- |
| T-Shirt - Black | Black         |
| T-Shirt - Blue  | Blue          |
| T-Shirt - Red   | Red           |

<mark style="color:red;">Assign an image to represent each option</mark>

<figure><img src="/files/Bl3WN1u3XxJAibQ8xeoD" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/OGodWOUSnXxVvLFeH7ne" alt=""><figcaption><p>Change color/image</p></figcaption></figure>

<mark style="color:$primary;">Change the alternative name for the product name</mark>&#x20;

By default, we use the product name as option value.

<figure><img src="/files/EEiXQ8yi58sdZAZBcz7Z" alt=""><figcaption><p>Change product title</p></figcaption></figure>
{% endstep %}

{% step %}

### Save the Group

After all products have been added and configured:

1. Click **Save**.
2. Open one of the grouped product pages.
3. Verify that the linked products appear as variant options.

***

### Result

Customers can switch between grouped products directly from the product page, just like selecting a regular Shopify variant.

Each product remains a separate Shopify product with its own:

* Product page
* URL
* Inventory
* SEO settings
* Search engine indexing

This provides a seamless shopping experience while maintaining the flexibility of separate products.

{% endstep %}
{% endstepper %}

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Change product group's position on product detail page

Use custom App Block to change the position of product group.

### Step 1: Open the Theme Editor

1. In Shopify Admin, go to **Online Store → Themes**.
2. Click **Customize** on your active theme.

<figure><img src="/files/r8HUDW4TIuAuhwKglqxy" alt=""><figcaption></figcaption></figure>

***

### Step 2: Add the App Block

1. Open a product page template.
2. In the left sidebar, click **Add Block**.
3. Select **Apps**.
4. Choose **Product Groups**.

The app block will be added to your product page.

<figure><img src="/files/f81WaOpI38oh6NrYC3r2" alt=""><figcaption></figcaption></figure>

***

### Step 3: Position the Block

Drag and drop the app block to the desired location within the product information section.

<figure><img src="/files/4AwcHHgZaFbqTUbW9bR1" alt=""><figcaption></figcaption></figure>

***

### Step 4: Save Your Changes

Click **Save** in the theme editor to publish the changes.

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!


# Show/hide product group on collection page

You can control whether a product group is displayed on collection pages.

### How to Configure

1. Open the **GLO Color Swatch** app.
2. Go to the **Product Groups** page.
3. Open the product group you want to update.
4. Find the **Show on Collection** dropdown.
5. Select one of the following options:
   * **Show** – Display the product group on collection pages.
   * **Do not show** – Do not display the product group on collection pages.
6. Click **Save**.

<figure><img src="/files/8B75MyMgejGBYCwQUqNI" alt=""><figcaption></figcaption></figure>

### Result

When enabled, customers will see the grouped product options directly on collection pages, allowing them to browse and switch between related products more easily.

When disabled, the product group will only be displayed on product pages.

***

**💬 Need help?**

Email us at **📧 <contact@globo.io>** - we’re happy to assist!




---

[Next Page](/llms-full.txt/1)

