> For the complete documentation index, see [llms.txt](https://bogos-guideline.gitbook.io/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bogos-guideline.gitbook.io/user-guide/detailed-guide/customize/customize-variant-input.md).

# Customize Variant input

This is where you choose how your product variants appear to customers.

You have two display options: **Show by variants** and **Show by options**.

### **1. Show by variants**

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

This option uses a dropdown menu for selecting product variants.

You can easily change this widget's background color by navigating to **Default display** -> **Active item background** and changing the color.

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

### 2. Show by options

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

There are two display options for you to choose from.&#x20;

* **Default display**: This shows variant values as labeled rectangular buttons.

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

* **Advanced display**: This shows variants as color swatches or image thumbnails.

<div data-full-width="false"><figure><img src="/files/ULDQTAhHYmka9Dtjjv4O" alt="" width="504"><figcaption></figcaption></figure></div>

If you want to customize the default option, simply go to **Default display** and adjust the color for each element.

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

When it comes to the **Advanced display**, you can set up separately for each variant set and choose between the Color swatch or Image thumbnail.

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

\
After that, select a variant set within this **Select option** table. BOGOS will automatically sync and display all variant values from your Shopify setup.<br>

<figure><img src="/files/XC9pJBjGjxv5EXFLMuBz" alt="" width="483"><figcaption></figcaption></figure>

In the next step, you will set up each variant value individually.

* For **Color Swatch** display: simply pick the corresponding color for each variant—either by entering a color code or by choosing from the color wheel.

<figure><img src="/files/MRIglqFE0VHZ4JTrVV8W" alt="" width="402"><figcaption></figcaption></figure>

* For **Image Thumbnail** display: upload images that clearly represent each variant value. These images must be under 20KB in size.

<figure><img src="/files/ViPYkB0DoTOg17iCVmw5" alt="" width="375"><figcaption></figcaption></figure>

For both types of display, you will find three buttons to help you adjust the setup:

* **Select option value**: Add any variant value that may have been missed or deleted.
* **Customize**: Adjust the appearance of your variant widget on your storefront with the following options.

&#x20;      ▶ *Select size*: Choose small, medium, or large for your buttons or swatches.

&#x20;      ▶ *Select swatch shape*: Pick between circles or squares for your swatches.

&#x20;      ▶ *Show variant name next to swatches*: Enable this option to display the variant name next to each swatch.

<figure><img src="/files/Hb7LudwM7WJ7cBYutxc3" alt="" width="563"><figcaption></figcaption></figure>

If you want to configure an additional variant set, click **Add variant set**. All steps of setup will be the same as provided above.

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

* Variant setups automatically apply to products that share the same variant option name.
* Each variant set can only use one display style.
  {% endhint %}

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://bogos-guideline.gitbook.io/user-guide/detailed-guide/customize/customize-variant-input.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
