> 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/swatch/variant-display/dropdown.md).

# Dropdown

{% hint style="success" %}
**Available on:** Product page, Collection page
{% endhint %}

✨Demo product: [Dropdown](https://optis-color-swatch-variant.myshopify.com/products/dropdown?_pos=1&_psq=drop&_ss=e&_v=1.0) (password: 1)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-1203c50f6482abb8e3e63fd8663627cdc6df5883%2Fdropdown-hero.png?alt=media" alt="Dropdown variant selector on a product"><figcaption></figcaption></figure>

### **Function**

Displays an option's values inside a **collapsed dropdown**, letting customers choose one value from a list — the most space-saving selector.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fmlp6XO0Haur3goXdNJi4%2Fimage.png?alt=media&amp;token=42b4b431-f5ba-40ff-8300-4968125778e7" alt=""><figcaption></figcaption></figure>

### **How it works**

* Values are hidden inside a **collapsed dropdown** until opened.
* Customers select **one value at a time**; the chosen value shows as the active choice.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FYToTSXAuAVRnL0pMIA84%2Fimage.png?alt=media&amp;token=ae79caaa-a419-4c42-812a-e4093c2aedc2" alt=""><figcaption></figcaption></figure>

* This is a **text-only** selector — no image or color, so there's no swatch editor to set up.

### **Use when**

* An option has **many values** and buttons/swatches would take too much room.
* You want to **save space** on the product or collection page.
* Options are **text-based** and don't need visual comparison.

***

## How to use Dropdown

{% stepper %}
{% step %}

#### Change the display type to Dropdown → Click Save

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F1JJy22Rcv6TJmxHCCe4D%2Fimage.png?alt=media&amp;token=a8d981f7-f617-44a2-9505-1b0ff31db85a" alt=""><figcaption></figcaption></figure>

In **Variants display**, set the option's **Product page display** (and/or **Collection page display**) to **Dropdown**. There's nothing to configure per value.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FXpRj3G3AIzpL78Kju8cU%2FScreenshot%20(6).png?alt=media&amp;token=0fd1f49b-2db1-4329-b4fa-e50eea40551d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### (Optional) Adjust the look in Styling

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FcPdb4whEQCImIWuodqx4%2FScreenshot%20(8).png?alt=media&amp;token=921c4e57-afe1-4342-a89d-1be31a818a06" alt=""><figcaption></figcaption></figure>

Padding, font, text and background colors are configured in [Styling](https://docs.optis.me/swatch/styling/styling-overview.md).
{% endstep %}
{% endstepper %}

***

## How it looks on your store

* **Product page:**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-d4f74a37214783eb4fb972ddfed0163e1cab20ec%2Fdropdown-product-page.png?alt=media" alt="Dropdown variant selector on the product page"><figcaption></figcaption></figure>

* **Collection page:**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9b07f3aac16d7d07fe27d8f68173c86341c3deda%2Fdropdown-collection-page.png?alt=media" alt="Dropdown variant selector on the collection page"><figcaption></figcaption></figure>

### Related

* [Button](https://docs.optis.me/swatch/variant-display/button.md) — text buttons when there are only a few values
* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md) — when values need a color or image
* [Styling settings reference](https://docs.optis.me/swatch/styling/styling-settings-reference.md) — font, padding, colors
