# New Dual Listbox Option Collection

## **Overview**

The New Dual Listbox Option Collection simplifies creating dynamic dual listbox components in your Salesforce screen flows. Dual listboxes allow users to select multiple items from one list and move them to another, making them ideal for scenarios where users need to categorize, prioritize, or associate items.

## **Setup and Configuration**

1. **Drag and Drop:** In the Flow Builder, locate the "New Dual Listbox Option Collection" action under the Avonni Actions category and drag it onto your flow canvas.
2. **Label (Required):** Provide a descriptive label for the action (e.g., "Assign Products to Categories"). This label serves as an internal reference within the flow builder.

### **Dual Listbox Options (Required)**

* **Label (Required for each option):** The text displayed for each item in the listbox (e.g., "Product A," "Category X").
* **Value (Required for each option):** The underlying value associated with each item, used in flow logic (e.g., product ID, category ID).
* **Description (Optional for each option):** Additional information about the item (e.g., product description, category details).
* **Group Name (Optional for each option):** Assign items to groups to improve organization within the listbox (e.g., "Electronics," "Apparel," etc.).
* **Avatar (Optional for each option):** Display an image or icon associated with the item (e.g., product image, category icon).

### **Add Item (Optional)**

Click the "Add Item" button to include more options in the dual listbox. For each item, provide the label, value, optional description, group name, and avatar.

## **Key Points**

* **Data Source:** Dual listbox options can be populated manually or dynamically from Salesforce objects, custom collections, or external data sources.
* **Default Values:** You can pre-select items to appear in the selected listbox by default.
* **Output Variable:** Store the selected values in a flow variable for further processing.
* **Filtering and Sorting:** Avonni components often offer features to filter and sort options within the dual listbox.

## **Example Use Cases:**

* **Product Categorization:** Allow users to assign products to different categories.
* **Team Assignment:** Enable managers to assign tasks or projects to team members.
* **Preference Selection:** Let users select their preferred communication channels or topics of interest.
* **Data Filtering:** Create dynamic filters for reports or dashboards by selecting relevant items from a dual listbox.

The New Dual Listbox Option Collection enables you to create interactive and efficient interfaces for managing relationships between items within your Salesforce screen flows. Empowering users to select, categorize easily, and associate items can streamline processes and enhance the overall user experience.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.avonnicomponents.com/flow/actions/ui-and-navigation/new-dual-listbox-option-collection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.