> For the complete documentation index, see [llms.txt](https://ursus-ecom.gitbook.io/arctos-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/variant-picker.md).

# Variant picker

Control how product options (size, color, material) appear across your store, including the product page, featured products, quick view, and quick add, among others.

{% hint style="info" %}
**Where to find it:** In the theme editor (**Customize**), go to **Theme settings > Variant picker**.
{% endhint %}

### 1. Style

Variant option buttons (used for options like size, material, or style) can be displayed in 3 shapes.

Choose a shape (Sharp, Rounded, or Pill) that aligns with your store's overall [main corner](https://ursus-ecom.gitbook.io/pages/MtcWsJuspkVnqjnkw5Ur#id-1.-global-style-main-corner) to maintain visual consistency:

* **Sharp:** Best if your main corner is `0px`
* **Rounded:** Best if your main corner radius is `10px` or `20px`.
* **Pill:** Best if your main corner is `30px`

While matching creates instant visual consistency, feel free to mix and match shapes to create a unique look that fits your brand.

{% hint style="info" %}
**Corner radius:** Only applies when Shape is set to Rounded. Accepts values from 4px to 16px.
{% endhint %}

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fgit-blob-94658322ac6d63838d90d82f345c679da6ce82c3%2Fvariant-picker-shape.webp?alt=media" alt=""><figcaption></figcaption></figure>

### 2. Color swatches

For options whose names are defined in the [Color swatches](https://ursus-ecom.gitbook.io/arctos-theme/theme-settings/color-swatches.md) settings, swatch display is configured directly on each **Variant picker** block (on the [Product page](https://ursus-ecom.gitbook.io/pages/1b80fc5dfcfb0eecd5483d5ca344f067c17cda39#id-3.-variant-picker), in [Featured product](https://ursus-ecom.gitbook.io/arctos-theme/section-templates/featured-product.md), and in [Quick view](https://ursus-ecom.gitbook.io/arctos-theme/section-templates/overlay-group/quick-view.md)) as well as in [Theme settings > Product card > Quick actions](https://ursus-ecom.gitbook.io/pages/ISlCs9f6QPtiUtSlhT0O#id-5.-quick-actions) for Quick add.

<figure><img src="https://1411897219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP6Y96SO1y456EU9GTaCh%2Fuploads%2Fjm7z2o2gYOykHXIe7ZoV%2Fproduct-card-swatches.png?alt=media&amp;token=cea17fd4-fd43-46ea-942a-1006bcb9973e" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="155">Setting</th><th width="175.52734375">Options</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Show color swatches</strong></td><td><ul><li>On</li><li>Off</li></ul></td><td>Displays color options as swatches instead of text buttons (default: <strong>On</strong>). <em>Available on the <strong>Variant picker</strong> block when <strong>Variant picker type</strong> is <strong>Button</strong>.</em></td></tr><tr><td><strong>Type</strong></td><td><ul><li>Color swatch</li><li>Variant image</li></ul></td><td><ul><li><strong>Color swatch:</strong> Displays a solid color chip based on the variant's color value (default). Best for most stores as no extra image setup is required.</li><li><strong>Variant image:</strong> Displays a thumbnail cropped from the variant's assigned product image. Use when you want shoppers to see the actual fabric, pattern, or texture rather than a flat color.</li></ul><p><em>Available on the <strong>Variant picker</strong> block when <strong>Variant picker type</strong> is <strong>Button</strong> and <strong>Show color swatches</strong> is <strong>On</strong>.</em></p></td></tr></tbody></table>

{% hint style="warning" %}
Variant image mode requires every variant to have an assigned image. Any variant missing an image will not render its swatch correctly. Audit your product images before enabling this mode. [Learn more](https://help.shopify.com/en/manual/products/variants/variant-images).
{% endhint %}
