> 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-link.md).

# Visual Picker Link

Show a clickable tile with a title, text, an icon and an optional progress bar, and send the user to the next screen or a page when they click it.

The Visual Picker Link is a single clickable tile: a title, a short text, an icon, and an optional progress indicator. Use it to start something rather than to record a choice, like an onboarding step that opens the next screen, or a link to the knowledge article the user needs.

## Overview

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FKUkJUXaJRW87udWBR5Mw%2Fvisual-picker-visual-picker-link-result.png?alt=media" alt="A Visual Picker Link tile titled Complete your company profile with an account icon and a progress bar at 60 percent" width="320"><figcaption><p>An onboarding tile with a progress bar.</p></figcaption></figure>

Each tile is one component. To show several steps, put several Visual Picker Links on the screen and mark the finished ones as **Completed**. To let the user choose between options and store the choice, use the [Visual Picker](https://docs.avonnicomponents.com/flow/flow-components/visual-picker.md) instead.

***

## Configuration

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

### Properties

| Property          | What it does                                                                                |
| ----------------- | ------------------------------------------------------------------------------------------- |
| **Title**         | The heading of the tile.                                                                    |
| **Content**       | Rich text displayed under the title.                                                        |
| **Icon Name**     | A Lightning Design System icon, for example `utility:knowledge_base` or `standard:account`. |
| **Icon Position** | Puts the icon on the **Left** *(default)* or the **Right**.                                 |
| **Completed**     | Shows the tile as done: a check badge is added to the icon.                                 |
| **Disabled**      | Grays out the tile. Clicking it does nothing.                                               |
| **Info Only**     | Shows the tile as information only. Clicking it does nothing.                               |

**Completed**, **Disabled** and **Info Only** accept a Boolean resource, so a formula or a record field can set them. For example, map **Completed** to a checkbox field that records whether the step is done.

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2F9XaDh140hZP8G5Mx4ilE%2Fvisual-picker-link-states.png?alt=media" alt="Four Visual Picker Link cards showing the default, completed, disabled and info-only states"><figcaption><p>The default card against the three states. <strong>Completed</strong> adds a check badge to the icon and <strong>Disabled</strong> grays out the whole card.</p></figcaption></figure>

### Progress

The **Progress** group adds a progress indicator to the tile. It is collapsed by default.

**Value** is the progress as a percentage, from `0` to `100`. Once it is set, these settings appear:

| Setting              | What it does                                                         |
| -------------------- | -------------------------------------------------------------------- |
| **Label**            | A text shown with the indicator, like `Profile complete`.            |
| **Type**             | **Bar** or **Circle**.                                               |
| **Position**         | **Top** or **Bottom** for a bar, **Left** or **Right** for a circle. |
| **Size**             | The indicator size. **Full** is available for a bar only.            |
| **Thickness**        | The thickness of the bar or the circle.                              |
| **Rounded**          | Rounds the ends of a bar.                                            |
| **Show Value**       | Displays the percentage.                                             |
| **Alternative Text** | The text a screen reader announces for the indicator.                |

<figure><img src="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FDPm4ugB36bPCQ9PB4KQz%2Fvisual-picker-link-progress.png?alt=media" alt="The Progress group of the Visual Picker Link property editor with every progress attribute" width="320"><figcaption><p>The <strong>Progress</strong> group, which opens on its own once a value is set.</p></figcaption></figure>

### Build an onboarding tile

A tile that shows how far the user got and opens the next screen when clicked.

{% stepper %}
{% step %}

#### Write the tile

Set **Title** to `Complete your company profile`, **Content** to `Add your billing address and tax ID.` and **Icon Name** to `standard:account`.
{% endstep %}

{% step %}

#### Show the progress

Open **Progress**, set **Value** to `60` or map it to a number resource, then set **Type** to **Bar** and turn on **Show Value**.
{% endstep %}

{% step %}

#### Make the click do something

In the **Interactions** tab, add an interaction to **Click**: **Flow Navigation** with **Next Screen** to move forward, or **Navigate** to open a record or a page.
{% endstep %}

{% step %}

#### Save and test

Run the flow. The tile shows a bar at 60 percent, and clicking it moves to the next screen.
{% endstep %}
{% endstepper %}

***

## Interactions

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

### Click

Fires when the user clicks the tile. It does not fire when the tile is **Disabled** or **Info Only**. The click also sets the **Is Clicked** output to `true`. Common actions are [Flow Navigation](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel/flow-navigation.md) and [Navigate](https://docs.avonnicomponents.com/flow/component-builder/interactions-panel/navigate.md).

***

## Styling

The **Style** tab sets the look of the tile. Some sections change with the **Info Only** setting.

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

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

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

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

{% tab title="Border" %}
Customizes the component and tile borders.

* **Color / Size / Style / Radius:** Control the component border color, thickness, line style, and corner roundness.
* **Color Hover / Color Disabled / Size Hover / Style Hover:** Set tile border styling for the hover and disabled states (interactive variant only).
  {% 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="Tile" %}
Sets the tile background.

* **Background Color:** Set the tile background color.
* **Background Color Disabled:** Set the tile background for the disabled state (interactive variant only).
  {% endtab %}

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

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

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

* **Line Clamp:** Limit the description to a maximum number of lines.
  {% endtab %}

{% tab title="Icon" %}
Styles the icon within the tile.

* **Background / Background Completed:** Set the icon background for the default and completed states.
* **Foreground:** Set the icon color.
* **Border Radius:** Control the roundness of the icon corners.
  {% endtab %}

{% tab title="Progress Bar" %}
Styles the optional progress bar.

* **Color / Completed Color:** Set the bar background and the completed-portion color.
* **Label Font Color / Label Font Size / Label Font Style / Label Font Weight:** Control the label typography.
* **Value Color / Value Font Size / Value Font Style / Value Font Weight:** Control the value typography.
  {% endtab %}

{% tab title="Progress Circle" %}
Styles the optional progress circle.

* **Background Color / Bar Color / Completed Bar Color:** Set the circle background, bar, and completed-bar colors.
* **Value Color / Value Font Style / Value Font Weight:** Control the value typography.
* **Label Font Color / Label Font Style / Label Font Weight:** Control the label typography.
  {% endtab %}

{% tab title="Separator" %}
Styles the separator between items.

* **Color:** Set the separator color.
* **Size / Style:** Control the separator thickness and line style.
  {% endtab %}
  {% endtabs %}

***

## Output Variables

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

### Click

| Output variable | Type    | What it returns                                           |
| --------------- | ------- | --------------------------------------------------------- |
| **Is Clicked**  | Boolean | `true` once the user has clicked the tile on this screen. |

> **Example:** A screen shows a `Read the setup guide` tile. After the screen, a **Decision** element checks **Is Clicked** and only marks the onboarding step as done when the user opened the guide.

### Flow Interaction Output Variables

Like all interactive Flow components, the Visual Picker Link 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>Clicking the tile does nothing</summary>

The tile is **Disabled** or **Info Only**: neither one fires **Click**. If both are off, check that the **Click** event in the **Interactions** tab has an interaction.

</details>

<details>

<summary>The progress settings are missing</summary>

They appear once **Value** in the **Progress** group is set.

</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-link.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.
