> For the complete documentation index, see [llms.txt](https://docs.optis.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.optis.me/product-options/20-option-types/choice-list/dropdown-menu-with-thumbnails.md).

# Dropdown Menu with Thumbnails

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

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

### 1. How Does the Dropdown menu with Thumbnails Display?

The Dropdown Menu with Thumbnails offers a visually enriched experience by displaying small thumbnail previews next to each dropdown value.

When customers click the dropdown, they will see both the option names and corresponding thumbnail images or colors, making it easier to visually recognize and choose the right product variant.

We support two types of thumbnails:

* 🎨 Color Thumbnail: Shows a solid color block next to the option value. Ideal for selecting colors (e.g., fabric colors, paint shades).
* 🖼️ Image Thumbnail: Shows a small preview image next to the option value. Great for displaying patterns, materials, product icons, flags, and more.

Example of how it appears on a product page:

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

### 2. How to Create a Dropdown menu with Thumbnails

**Step 1: Add a New Option**

* Open **1. Add options**, click **Add option**, tick **Dropdown with thumbnail** under **Choice list** on the **New options** tab, then click **Add options**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FanNXZZtTIK9MPVpTqIfv%2F4.png?alt=media&amp;token=bec90b8c-bb0a-4af6-a63d-081da52bb432" alt=""><figcaption></figcaption></figure>

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

**Step 2: Add information to the** Dropdown menu with Thumbnails

* Enter a label for the dropdown (e.g., Choose Color, Select Pattern, Pick Style)
* Option Values: Add the values (e.g., Pink, Blue, Marble).<br>

  <figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FdnQo2CUbXaJtwk5uRK3h%2F3.png?alt=media&amp;token=e8505519-a736-43ef-b973-b0018c9c5008" alt=""><figcaption></figcaption></figure>
* Tick on “Required field” if you want customers must choose the option before checking out.
* Tick on "Hide option label” if you don’t want to show the option name above the option values.
* Assign the Thumbnails: You now have two choices depending on what fits your product:

🎨 Use Color Thumbnails: Click the swatch button (**Edit swatch**) next to the value to open **Add option value thumbnail**, choose the **Color** tab, then enter a hex code in **Color Picker (hex)** or pick a color, and click **Done**. The app displays a square color thumbnail beside the option in the dropdown.

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfhWnc4x_RcYBaLCY6KZqW-3j2rkeL8L1cRkqIefblYMUY7k2hyZ598-6p1pV769pxOnQSY5_psKcYSSaFpsivPNl9w0GJHuYS9MMbpmUo9743N9JjHstHkWrUTW1lSn_T3Tr0r?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

🖼️ Use Image Thumbnails: Click **Edit swatch** next to the value, choose the **Image** tab, then use **Add images** to upload an image (JPG, JPEG, PNG, SVG or GIF, up to 5 MB) or select one from **OPTIS files** or **Shopify files**, and click **Done**.

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

> **Recommended size:** 50x50px or similar square dimensions to keep things neat.
>
> **Note:** Each value has its own thumbnail (a color or an image). For a neat look, we recommend using the same style for all values of a dropdown.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd_23_2iN7urG5rZovhwXVMKdzE6NX2Q2a1At31aByGYa7ufeXvxIGI_u7nLW-tV73Mq_QC_zMhpaj7sDRR_EVbgyoVplmbp43qFA0H7efSLAoCmHcSYlq7XN6sOgybFmOxkqDu9A?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

Other features:

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

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

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

Example: Show "Choose Material" only if “Customize Design = Yes”

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FnB1xDeCVRh0OwoQupE5i%2F1.png?alt=media&amp;token=9a55fdce-ceb8-44d2-aab0-d60fc0af5bc0" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfGd8Eh9yMNVoP4G-LAw3vCS6FtcXDivHvrnkUAZFhmhruMd_msYgDUkAZHb4vEyckiF1p_gl0ysBEIc9Sx-4fqIKBp9UparbVuy82DDOUZeSa1APiViZpIqqam0hVWIPuiJ0_qQQ?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

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

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

Example: Default to “White” if most customers choose that.

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

{% hint style="success" %}
**Default text on dropdown:** Display placeholder text in the dropdown before the customer makes a selection.
{% endhint %}

Example: Set a placeholder like “Choose a style…” that disappears after selection.

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

{% hint style="success" %}
**Search bar:** If your dropdown contains a long list of options, enable a search bar to make it easier for customers to find their preferred choice.
{% endhint %}

Example: If you have more than 10-15 options, you can enable a small search bar for better usability.

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

{% hint style="success" %}
**Limit selectors:** In the **Quantity** section, tick **Limit how many different option values can be selected** to let customers pick more than one value (for example, "Pick up to 3 toppings"), then set **Min selected option values** and **Max selected option values**. See [Limit min/max selectors](/product-options/faq/limit-min-max-selectors-in-checkbox-button-options-swatch.md).
{% endhint %}

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

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

Example: Select multiple fragrances for one dropdown menu with thumbnails option

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FBJZZeus9Bm6s1R7bSZn9%2FScreenshot%20-%202026-01-12T171456.403.png?alt=media&amp;token=254bad3f-b3d8-4b41-9550-6e4fb2cb87c0" alt=""><figcaption></figcaption></figure>

**Step 4: Save and Test**

* Click Save to apply the settings.
* Visit the product page on your store to check if the dropdown menu with thumbnails option works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fqjecu4BvQRIZl8X4gVbj%2F21.png?alt=media&amp;token=5ded77fa-0ff9-4062-81bf-9d511a765ff1" alt=""><figcaption></figcaption></figure>

### 3. Real-World Applications of Dropdown menu with thumbnails

* Fashion: Shirt color, fabric style, or button designs
* Home & Decor: Furniture finishes, wall color options
* Custom Gifts: Engraving icons, packaging patterns
* International Products: Flag thumbnails for language or country options
* Food & Beverage: Cupcake toppings, smoothie base colors
