> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/flow/flow-components/visual-picker.md).

# Visual Picker

Let users pick one or several options from a grid of cards with images, avatars and tags, then use the choice in the rest of your screen flow.

## Overview

The Visual Picker shows a set of choices as cards in a grid, and the user selects one or several of them. A support rep picks the customer's plan from three cards, or a customer ticks the product lines they use.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FQ7SaxtlVltrTmFimo8Ec%2Fvisual-picker-visual-picker-result.png?alt=media" alt="A Visual Picker with three support plan cards, Basic, Plus and Premier, with Plus tagged Most popular and selected"><figcaption><p>Three support plans as cards, with Plus selected.</p></figcaption></figure>

Use the Visual Picker when an option is easier to recognize from a picture, an avatar or a short description than from a single word in a radio list. Each card can carry a title and a description inside the card, a second title and description under it, an image or an avatar, tags, and a small set of fields.

* For a vertical list of rows with optional sub-options, use the [Vertical Visual Picker](https://docs.avonnicomponents.com/flow/flow-components/vertical-visual-picker.md).
* For a single clickable tile that starts an action instead of recording a choice, use the [Visual Picker Link](https://docs.avonnicomponents.com/flow/flow-components/visual-picker-link.md).

***

## Tutorials

Four step-by-step tutorials build on this page. The [Visual Picker tutorials](https://docs.avonnicomponents.com/flow/tutorials/components/visual-picker.md) hub groups them with the Vertical Visual Picker ones.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Build Visual Picker Items by Hand</strong></td><td>Three support plans as cards, with a "Most popular" tag and a plan that cannot be picked.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FKpfWJAvw5qFmLNsFPhPE%2Fflow-hub-cover-visual-picker.png?alt=media">flow-hub-cover-visual-picker.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/visual-picker/build-visual-picker-items.md">Build Visual Picker items by hand</a></td></tr><tr><td><strong>Show Records as Visual Picker Cards</strong></td><td>Show an account's open opportunities as cards, then load the one the rep picks.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2Fwz4ms3MJb6rif1AXsp5a%2Fvisual-picker-cover-show-records-as-visual-picker-cards.png?alt=media">visual-picker-cover-show-records-as-visual-picker-cards.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/visual-picker/show-records-as-visual-picker-cards.md">Show records as Visual Picker cards</a></td></tr><tr><td><strong>Limit and Pre-Select Visual Picker Choices</strong></td><td>Ask for two to three onboarding modules, with one already selected when the screen opens.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FtJyvsgn39W33pEdsVZyU%2Fvisual-picker-cover-limit-and-preselect-visual-picker-choices.png?alt=media">visual-picker-cover-limit-and-preselect-visual-picker-choices.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/visual-picker/limit-and-preselect-visual-picker-choices.md">Limit and pre-select Visual Picker choices</a></td></tr><tr><td><strong>Save Multiple Picks to a Picklist Field</strong></td><td>Let a customer tick the product lines they use and save them to a multi-select picklist.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FEZpqEfHJdJNY6eaIpRHO%2Fvisual-picker-cover-save-multiple-picks-to-a-picklist-field.png?alt=media">visual-picker-cover-save-multiple-picks-to-a-picklist-field.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/visual-picker/save-multiple-picks-to-a-picklist-field.md">Save multiple picks to a picklist field</a></td></tr></tbody></table>

***

## Projects

See this component in a complete Salesforce workflow. This project uses Avonni Dynamic Components and includes AI-assisted and manual build steps.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><h4><a href="https://docs.avonnicomponents.com/projects/use-cases/portals-and-partner-sites/portal-case-deflection">Portal Case Deflection</a></h4></td><td>Ask what the question is about, then answer it, so the case is never opened.</td><td data-object-fit="fill"><a href="https://3857391697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdHOej9Pd5IxJNGEJMZKW%2Fuploads%2FlV6k5IAUxIOsys3ReN7c%2Fportal-case-deflection-cover.png?alt=media">https://3857391697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdHOej9Pd5IxJNGEJMZKW%2Fuploads%2FlV6k5IAUxIOsys3ReN7c%2Fportal-case-deflection-cover.png?alt=media</a></td></tr></tbody></table>

## Configuration

Click the component on the flow screen. The **Edit Visual Picker Component** panel opens on the right with three tabs: **Properties**, **Interactions** and **Style**. The sections below follow the **Properties** tab.

### Data Source

The **Data Source** setting decides where the cards come from.

| Data Source                                                                                       | Use it when                                                                       |
| ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [**Manual**](https://docs.avonnicomponents.com/flow/component-builder/data-sources/manual.md)     | The choices are fixed and you type them in the panel, like three support plans.   |
| [**Variable**](https://docs.avonnicomponents.com/flow/component-builder/data-sources/variable.md) | A **Get Records** or an Assignment earlier in the flow already holds the records. |
| [**Picklist**](https://docs.avonnicomponents.com/flow/component-builder/data-sources/picklist.md) | The choices are the values of a picklist field, like Account **Industry**.        |
| [**Query**](https://docs.avonnicomponents.com/flow/component-builder/data-sources/query.md)       | The component should fetch the records itself, without a **Get Records** element. |

Not sure between Variable and Query? See [Query vs Variable](https://docs.avonnicomponents.com/flow/component-builder/data-sources/query-vs-variable.md).

With **Picklist**, each card shows only the value's label. It cannot carry an image, an avatar, a description or tags, so use **Size** **Small** or larger.

### Data Mapping

With **Variable** or **Query**, open **Data Mappings** to tell the component which field fills which part of the card. Map **Value** to a field that is unique per record (the record Id is the safe choice).

Then map **Figure Title**, **Figure Description**, **Image Source** or **Avatar** to the fields you want to show. The mappable attributes are the same as the item fields in the next section.

> **Example:** On an Account screen, query the account's open Opportunities, map **Value** to `Id`, **Figure Title** to `Name` and **Figure Description** to `StageName`. The rep sees one card per deal. [Show records as Visual Picker cards](https://docs.avonnicomponents.com/flow/tutorials/components/visual-picker/show-records-as-visual-picker-cards.md) builds this end to end.

### Items

With **Manual**, you build each card by hand in the **Items** list. Every item has these fields:

| Item field                 | What it does                                                                                                                                                                                  |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Figure Title**           | The title displayed inside the card.                                                                                                                                                          |
| **Value**                  | A unique value for the item. This is what the outputs return when the card is selected.                                                                                                       |
| **Figure Description**     | Rich text displayed under the figure title, inside the card.                                                                                                                                  |
| **Title**                  | A second title, displayed under the card.                                                                                                                                                     |
| **Description**            | Rich text displayed under that title, under the card.                                                                                                                                         |
| **Image Source**           | The image of the card. When an item has both an image and an avatar, the image is shown.                                                                                                      |
| **Image Alternative Text** | The text a screen reader announces for the image.                                                                                                                                             |
| **Disabled**               | Grays out this one card. The user cannot select it.                                                                                                                                           |
| **Avatar**                 | An avatar with **Variant** (Circle or Square), **Initials**, **Icon Name**, **Size**, **Image Source**, **Presence** (Online, Busy, Focus, Offline, Blocked, Away) and **Presence Position**. |
| **Tags**                   | Small badges on the card. Each tag has a **Label** and a **Variant** (Alt-Inverse, Base, Brand, Error, Info, Inverse, Offline, Success, Warning).                                             |

**Disabled** accepts a Boolean resource, so a formula can decide per item. For example, a formula that returns true when the account has no active contract can disable the Premier card.

[Build Visual Picker items by hand](https://docs.avonnicomponents.com/flow/tutorials/components/visual-picker/build-visual-picker-items.md) builds three support plan cards step by step, with an icon per card, a `Most popular` tag and one disabled item.

### Properties

**Label** is the text displayed above the picker.

**Type** decides how many cards the user can select.

| Type                  | What it does                                                            |
| --------------------- | ----------------------------------------------------------------------- |
| **Radio** *(default)* | One card at a time. Selecting a card clears the previous one.           |
| **Checkbox**          | Several cards. Required to save picks to a multi-select picklist field. |

**Value** (with **Radio**) and **Value Collection** (with **Checkbox**) hold the cards that start selected. See [Pre-Selected Items](#pre-selected-items).

**Size** sets the size of each card: **Xx-Small**, **X-Small**, **Small**, **Medium** *(default)*, **Large**, **X-Large**, **Xx-Large** or **Responsive**.

At **Xx-Small** and **X-Small** only the item's avatar is displayed: titles and descriptions are hidden at those two sizes, so items that carry only text render as empty tiles. **Small** is the smallest size that keeps the text.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FXUSzKFxjzNO7g5jNr5jv%2Fvisual-picker-size.png?alt=media" alt="The same three picker items rendered at Xx-Small, X-Small, Small and Medium"><figcaption><p>The same three items at four sizes. Small is the smallest size that draws the title and the description.</p></figcaption></figure>

**Ratio** sets the shape of each card: **1-by-1** *(default)*, **4-by-3**, **16-by-9**, **3-by-4** or **9-by-16**. It appears for every size except **Responsive**.

**Variant** sets how a selected card looks.

| Variant                       | What it looks like                                       |
| ----------------------------- | -------------------------------------------------------- |
| **Non Coverable** *(default)* | A check mark appears in the corner of the selected card. |
| **Coverable**                 | The whole card is covered when selected.                 |

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FhgapwYrN8P1XKecAvj4h%2Fvisual-picker-visual-picker-variant.png?alt=media" alt="A selected Visual Picker card with the Non Coverable variant next to the same card with the Coverable variant" width="375"><figcaption><p>Non Coverable marks the selected card with a check mark, Coverable covers the whole card.</p></figcaption></figure>

**Required** stops the user from moving to the next screen until they select a card.

**Hide Check Mark** hides the check mark on selected cards.

**Disabled** grays out the whole picker. To disable a single card, use the item's own **Disabled** field instead.

### Pre-Selected Items

A pre-selected card saves a click when one answer is the usual one, or when the user comes back to a screen and should see what they already chose.

{% stepper %}
{% step %}

#### Pick the property that matches the Type

With **Radio**, set **Value** to one item's value, for example `plus`. With **Checkbox**, add values to **Value Collection**, or map it to a text collection variable. The picker matches on the item's **Value**, never on its title.
{% endstep %}

{% step %}

#### With a Variable data source, use a record collection

When **Data Source** is **Variable**, a **Default Selection Collection** field appears under the collection. Select a record collection of the same object: the cards whose records it contains start selected.
{% endstep %}

{% step %}

#### Test in debug mode

Run the flow. The cards you set start selected, and the user can still change them.
{% endstep %}
{% endstepper %}

[Limit and pre-select Visual Picker choices](https://docs.avonnicomponents.com/flow/tutorials/components/visual-picker/limit-and-preselect-visual-picker-choices.md) combines a default with a minimum and a maximum.

### Item Layout

Positions the content inside each card. The group is collapsed by default.

* **Title Position**: where the figure title sits in the card: **Top**, **Bottom** or **Center**.
* **Description Position**: where the figure description sits: **Top**, **Bottom** or **Center**.
* **Avatar Position**: where the avatar sits: **Top**, **Bottom**, **Left to the title**, **Right to the title**, **Left to the content** or **Right to the content**.

### Image

Controls the item images.

* **Image Fallback**: an image shown when an item's image is missing or cannot load.
* **Position**: where the image sits: **Left**, **Right**, **Top**, **Bottom**, **Background** or **Overlay**.
* **Size**: **Small**, **Medium** or **Large**. It sets the image width for **Left** and **Right**, and its height for the other positions.
* **Height**: a height in pixels that overrides **Size** for **Top**, **Bottom**, **Background** and **Overlay**.
* **Crop Fit**: how the image fills its space: **Cover**, **Contain**, **Fill** or **None**.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FLiLHalC87ONirzoeTZsf%2Fvisual-picker-image-position.png?alt=media" alt="One picker item drawn with the image at each of the six positions"><figcaption><p>The six image positions. <strong>Background</strong> and <strong>Overlay</strong> put the image behind the text; the other four place it beside or above it.</p></figcaption></figure>

### Fields Layout

Lays out the item **Fields** inside each card.

* **Number of Columns**: **1 Col**, **2 Cols**, **3 Cols**, **4 Cols**, **6 Cols** or **12 Cols**.
* **Variant**: how each field label shows: **Standard**, **Label Hidden**, **Label Inline** or **Label Stacked**.

### Layout

The **Layout** group appears only when **Size** is **Responsive**. A responsive picker stretches its cards to fill a grid, and the number of columns follows the width of the container the picker sits in, not the width of the browser window. That keeps the cards readable on a phone and side by side on a desktop.

| Setting                                | Applies from            |
| -------------------------------------- | ----------------------- |
| **Number of Columns**                  | The narrowest container |
| **Number of Columns Small Container**  | 480px wide              |
| **Number of Columns Medium Container** | 768px wide              |
| **Number of Columns Large Container**  | 1024px wide             |

Each one takes **1 Col**, **2 Cols**, **3 Cols**, **4 Cols**, **6 Cols** or **12 Cols**.

{% stepper %}
{% step %}

#### Switch the size to Responsive

Set **Size** to **Responsive**. **Ratio** disappears, because a responsive card takes the width of its column.
{% endstep %}

{% step %}

#### Set the columns per width

Open **Layout**. For three cards, set **Number of Columns** to **1 Col** and **Number of Columns Medium Container** to **3 Cols**: one card per row on a phone, three across from 768px.
{% endstep %}

{% step %}

#### Check it on a narrow screen

Run the flow, then narrow the browser window. Below 768px of container width the cards go from three across to one per row.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
The avatar-only rule depends on the fixed size, not on the screen: a picker set to **Xx-Small** or **X-Small** hides titles and descriptions everywhere. To shrink cards on small screens and keep the text, use **Responsive** with fewer columns.
{% endhint %}

### Advanced Options

These settings sit in the advanced part of the panel.

**Min** is the minimum number of cards the user must select. It appears when **Type** is **Checkbox**. Default: `0`.

**Max** is the maximum number of cards the user can select. It appears when **Type** is **Checkbox**. Once the user reaches it, the cards that are not selected are grayed out until they clear one. With **Max** set to `1`, selecting another card replaces the current one, and the user can still clear it.

**Name** is the name of the picker input. Set a different one on each picker when a screen holds more than one.

***

## Interactions

[Interactions](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel.md) define what happens when users interact with the Visual Picker. Configure them from the **Interactions** tab of the Edit Visual Picker panel.

### Change

Fires when the user selects or clears a card. **Value**, **Value Collection**, **Selected Item** and **Selected Items** are updated before the interaction runs.

### Item Click

Fires when the user clicks a card, whether or not the selection changes. **Clicked Item** and **Clicked Item Value** are updated before the interaction runs.

***

## Styling

The **Style** tab sets the look of the picker and its cards.

{% tabs %}
{% tab title="Margin" %}
Controls the *outer* spacing around the picker.

* **Top / Right / Bottom / Left:** Adjust the space on each side.
  {% endtab %}

{% tab title="Padding" %}
Controls the *inner* spacing between the picker's content and its border.

* **Top / Right / Bottom / Left:** Adjust the inner spacing on each side.
  {% endtab %}

{% tab title="Size" %}
Controls the picker's dimensions.

* **Width / Height:** Set fixed dimensions.
* **Overflow:** Control how content that exceeds the bounds is handled.
* **Min Width / Max Width / Min Height / Max Height:** Constrain the size within bounds.
  {% endtab %}

{% tab title="Flow Dialog" %}
Adjusts display when opened as a modal dialog inside a Flow screen.

* **Width:** Dialog width.
* **Height:** Dialog height.
* **Background Color:** Dialog background color.
  {% endtab %}

{% tab title="Background" %}
Sets the item background across states.

* **Background Color / Background Color Hover / Background Color Selected:** Set the background for the default, hover, and selected states.
  {% endtab %}

{% tab title="Border" %}
Customizes the item border across states.

* **Size / Radius / Style:** Control the border thickness, corner roundness, and line style.
* **Color / Color Hover / Color Selected:** Set the border color for the default, hover, and selected states.
* **Shadow:** Apply a box shadow.
  {% endtab %}

{% tab title="Label" %}
Styles the item label text.

* **Color:** Set the label text color.
* **Font Size / Font Style / Font Weight:** Control the label typography.
  {% endtab %}

{% tab title="Figure Title" %}
Styles the figure title text.

* **Color / Selected Color:** Set the title color for the default and selected states.
* **Font Size / Font Style / Font Weight:** Control the title typography.
* **Line Clamp:** Limit the title to a maximum number of lines.
  {% endtab %}

{% tab title="Figure Description" %}
Styles the figure description text.

* **Color / Selected Color:** Set the description color for the default and selected states.
* **Font Size / Font Style / Font Weight:** Control the description typography.
* **Line Clamp:** Limit the description to a maximum number of lines.
  {% endtab %}

{% tab title="Title" %}
Styles the item title text.

* **Color:** Set the title text color.
* **Font Size / Font Style / Font Weight:** Control the title typography.
  {% endtab %}

{% tab title="Description" %}
Styles the item description text.

* **Color:** Set the description text color.
* **Font Size / Font Style / Font Weight:** Control the description typography.
* **Line Clamp:** Limit the description to a maximum number of lines.
  {% endtab %}

{% tab title="Responsive Sizing" %}
Constrains the item height responsively.

* **Min Height / Max Height:** Set the responsive height bounds.
  {% endtab %}

{% tab title="Avatar" %}
Controls avatar placement.

* **Vertical Alignment:** Align avatars within the picker (top, center, bottom).
  {% endtab %}

{% tab title="Tag" %}
Styles the tag typography and shape.

* **Font Size / Font Style / Font Weight:** Control the tag typography.
* **Border Size / Border Style / Border Radius:** Control the tag border thickness, line style, and corner roundness.
* **Line Height:** Set the tag line height.
  {% endtab %}

{% tab title="Tag Colors" %}
Sets the tag colors. **Background**, **Border Color**, and **Text Color** are set per variant (Alt Inverse, Base, Brand, Error, Info, Inverse, Offline, Success, Warning).

* **Background:** Set the tag background color.
* **Border Color:** Set the tag border color.
* **Text Color:** Set the tag text color.
  {% endtab %}
  {% endtabs %}

***

## Output Variables

After the screen, select the screen element in Flow Builder, then the Visual Picker, and pick the output you need.

### Item Selection

Updated when the user selects or clears a card (the **Change** interaction).

| Output variable      | Type              | What it returns                                                                                                                                                                                                                          |
| -------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Value**            | Text              | The value of the selected card. With **Checkbox**, the values of all selected cards joined by semicolons, for example `Hardware;Software`. That is the format a multi-select picklist field stores.                                      |
| **Value Collection** | Text Collection   | The values of all selected cards, one per element.                                                                                                                                                                                       |
| **Selected Item**    | Record            | The record behind the selected card, with a **Variable** or **Query** data source only. With **Checkbox**, the record of the first selected card, in display order. With **Manual** or **Picklist** cards it stays empty: use **Value**. |
| **Selected Items**   | Record Collection | The records behind all selected cards, with a **Variable** or **Query** data source only.                                                                                                                                                |

Which one to use:

* **Radio**, to store the choice in a text field: **Value**.
* **Radio**, when you need other fields of the chosen record: **Selected Item**.
* **Checkbox**, to save to a multi-select picklist field: **Value**.
* **Checkbox**, to loop over the picks or pass them to an action: **Value Collection** or **Selected Items**.

To save several picks to a multi-select picklist field, **Type** must be **Checkbox** and **Update Records** must read **Value**. [Save multiple picks to a picklist field](https://docs.avonnicomponents.com/flow/tutorials/components/visual-picker/save-multiple-picks-to-a-picklist-field.md) walks through it with a product-line field.

### Item Click

Updated when the user clicks a card (the **Item Click** interaction).

| Output variable        | Type   | What it returns                              |
| ---------------------- | ------ | -------------------------------------------- |
| **Clicked Item**       | Record | The record behind the card the user clicked. |
| **Clicked Item Value** | Text   | The value of the card the user clicked.      |

> **Example:** After a screen of product tiers, a **Display Text** element that references `{!Visual_Picker.clickedItemValue}` shows the last tier the user clicked.

### Others

| Output variable                 | Type    | What it returns                                                             |
| ------------------------------- | ------- | --------------------------------------------------------------------------- |
| **Number of Items**             | Integer | The number of cards loaded in the picker.                                   |
| **Value Collection Serialized** | Text    | The selected values as a JSON array, for example `["Hardware","Software"]`. |

### Flow Interaction Output Variables

Like all interactive Flow components, the Visual Picker exposes generic output slots (Variable 1 to 10) that an [Open Flow Dialog](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel/open-flow-dialog.md) or [Open Flow Panel](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel/open-flow-panel.md) interaction can fill with values from a launched flow. See [Flow Interaction Output Variables](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel/flow-interaction-output-variables.md).

***

## Troubleshooting Common Issues

<details>

<summary>The user can only select one card</summary>

**Type** is set to **Radio**, the default. Set it to **Checkbox**. **Value Collection**, **Min** and **Max** only appear after that change.

</details>

<details>

<summary>The cards are empty tiles with no text</summary>

**Size** is **Xx-Small** or **X-Small**. At those sizes only the avatar is displayed. Use **Small** or larger, or give each item an avatar.

</details>

<details>

<summary>I cannot find Ratio or the Layout group</summary>

They depend on **Size**. **Ratio** shows for every size except **Responsive**, and **Layout** shows only for **Responsive**.

</details>

<details>

<summary>The other cards turn gray after a few picks</summary>

The user reached **Max**. The remaining cards come back as soon as they clear a selected one.

</details>

<details>

<summary>A card shows an image instead of its avatar</summary>

The item has both **Image Source** and an **Avatar**. The image takes priority. Clear **Image Source** to show the avatar.

</details>

<details>

<summary>The multi-select picklist field saves only one value</summary>

Check that **Type** is **Checkbox** and that **Update Records** reads the **Value** output, not **Clicked Item Value**, which only ever holds one value.

</details>


---

# 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://docs.avonnicomponents.com/flow/flow-components/visual-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.
