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

# Variant picker

The **Variant Picker b**lock allows customers to select product variants such as size, color, or style. It supports optional size chart links and subscription features, enhancing the shopping experience and helping guide customer decisions.

>  Only one Variant Picker block is allowed per section (`limit: 1`).

<figure><img src="https://2636770384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsD7BEEDU3B7WiEJlN0F7%2Fuploads%2FnQzIG8awKPWb8cZO5B9F%2Fvariant-picker.gif?alt=media&amp;token=6c461fcb-20c0-4798-b4b8-5fe6f7158a29" alt="Gif depicting the Variant Picker block of the product pages section"><figcaption></figcaption></figure>

<table><thead><tr><th width="240.4522705078125">Settings</th><th width="110.171875" align="center">Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>Size chart</strong></td><td align="center"></td><td></td></tr><tr><td>Page</td><td align="center"><code>page</code></td><td>Selects a page to link as a size chart.</td></tr><tr><td>Style</td><td align="center"><code>select</code></td><td>Defines the icon or text style for the size chart link. Options: <code>Text</code>, <code>Ruler</code>, or <code>Question mark</code>. </td></tr><tr><td><strong>Typography</strong></td><td align="center"></td><td></td></tr><tr><td>Option size</td><td align="center"><code>select</code></td><td>Controls the font size of the option labels: <code>Extra small</code>, <code>Small</code>, <code>Medium</code>, <code>Large</code>, and <code>Extra large</code>.</td></tr><tr><td>Value size</td><td align="center"><code>select</code></td><td>Sets the font size of the selectable values. Adjust for layout consistency: <code>Extra small</code>, <code>Small</code>, <code>Medium</code>, <code>Large</code>, and <code>Extra large</code>.</td></tr><tr><td><strong>Subscriptions</strong></td><td align="center"></td><td></td></tr><tr><td>Enable subscription selectors</td><td align="center"><code>boolean</code></td><td>Enables display of subscription plan selectors on products that support subscriptions. </td></tr><tr><td><strong>Padding</strong></td><td align="center"></td><td></td></tr><tr><td>Bottom</td><td align="center"><code>range</code></td><td>Adds space below the block.</td></tr></tbody></table>

## Notes

* The size chart link provides extra context for sizing decisions. It's especially helpful for apparel and footwear.
* If the product supports Shopify [subscriptions](https://help.shopify.com/en/manual/products/purchase-options/subscriptions), enabling selectors will display options like 'Subscribe and Save.'
* Make sure your product options are properly configured in Shopify's admin for this block to work correctly.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://broadcast.presidiocreative.com/product-theme-blocks/variant-picker.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.