> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/product-page/product-information/variant-picker.md).

# Variant picker

The Variant picker block lets shoppers choose a product option, such as size or color, as a dropdown, buttons, text or swatches. The selected value shows next to the option name (for example, Color: Black).

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FRhKgqNqbhvaTsqmHPjAt%2FScreenshot%202025-09-22%20at%204.26.35%E2%80%AFPM.png?alt=media&amp;token=955f7db8-60d7-46ba-ad4a-0aa768dbb41d" alt=""><figcaption></figcaption></figure>

### 1. How to add the block

In the **Product information** section, click **Add block** and choose **Variant picker**. The block only appears on products that have more than one variant.

### 2. Block settings

* **Desktop variant style:** how options look on desktop. Options: Dropdown, Button or Text.

{% tabs %}
{% tab title="Dropdown" %}
Each option is a dropdown menu. On mobile, the menu opens as a panel from the bottom of the screen.
{% endtab %}

{% tab title="Button" %}
Each value is a clickable button.
{% endtab %}

{% tab title="Text" %}
Each value is plain text, and the selected value is underlined.
{% endtab %}
{% endtabs %}

* **Mobile variant style:** the same choices for mobile: Dropdown, Button or Text.
* **Button layout:** how buttons are arranged when the style is Button. Options: Default (buttons size to their text), 2 columns or 3 columns. The default is 3 columns.

**Swatches**

Swatches show a color or image for each value instead of text. They appear for options whose values have swatches set up in your Shopify admin. Set the swatch shape and look in [Theme settings > Swatches](https://help.byinspiredlabs.com/theme-settings/swatches.md).

* **Enable swatches:** shows swatches for options that have them.
* **Size:** Regular, Large or Custom.
  * **Width** and **Height:** appear when you choose Custom. Set each from 16 to 120px.
* **Corner radius:** Default uses the shape from Theme settings > Swatches. Choose Custom to set your own.
  * **Radius:** appears when you choose Custom. Set from 0 to 40px.
* **Hover style:** what shoppers see when they hover over a swatch. Options: Image preview (a larger preview with the value name) or Tooltip (a small label with the value name).

**Size guide**

Add a link next to an option, such as Size, that opens a popup with your size chart.

* **Enable popup link:** shows the size guide link.
* **Option trigger name:** the option names that show the link. Separate names with commas (for example, `Size, Größe`).
* **Link label:** the link text. Default: Size guide.
* **Page:** the page whose content opens in the popup. Create the page first in **Online Store > Pages**.

{% hint style="info" %}
**Note:** Padding, section width, section header and color settings work the same in every section. See [Common settings](https://help.byinspiredlabs.com/section/common-settings.md).
{% endhint %}
