You are here:
Choice Lookup Screen Input Component
Let users search for and select one option from a set of choices on a flow screen. The component supports only Text values.
Required Editions
| View supported editions. |
Configure the Choice Lookup Component
| Attribute | Description |
|---|---|
| Label | User-friendly text that appears above the component. |
| API Name | The API name of the component. An API name can include underscores and alphanumeric characters without spaces. It must begin with a letter and can’t end with an underscore. It also can’t have two consecutive underscores. |
| Require | Requires users to select a value before they can move to the next screen. |
| Disabled | If set to true, the user can’t modify the value. The default value is false. This attribute accepts a resource with a Boolean value. |
| Placeholder Text | Text that appears in the field when it’s empty. Use placeholder text to give users a hint about what to enter in the field. This attribute accepts a resource with a single value. The value is treated as text. |
| Let Users Select Multiple Options | Specifies whether the user can choose only one option or multiple options. The user can select up to 25 options. |
| Choice | Add at least one Choice resource such as a record choice set or picklist choice set to this component. Available only when you add a choice component to the screen component. If you select a dynamic Choice resource such as a collection choice set or record choice set, ensure that each value in the Choice resource is unique. Otherwise, if a user selects a duplicate value, the value is set incorrectly in Salesforce. You can’t reorder choices or select the same choice twice. Choices must be compatible with the component’s Data Type setting. |
Access the Choice Lookup Component’s Values in the Flow
The flow stores these attributes automatically. You can’t store output values for the Choice Lookup component manually.
| Attribute | Description |
|---|---|
| selectedChoiceLabels | If users can select only one option, the label of the choice option that the user running the flow selected. If users can select multiple options, the semi-colon separated labels of all the choice options the user running the flow selected. Reference the
value later in the flow as |
| selectedChoiceValues | If users can select only one option, the value of the choice option that the user running the flow selected. If users can select multiple options, the semi-colon separated values of all the choice options the user running the flow selected. Reference the
value later in the flow as |
Set the Component Visibility
Specify the logic that determines when the flow displays the component.
| Option | Description |
|---|---|
| When to Display Component | Configure when the component is displayed by using conditional logic. You can set the components to:
|
Specify the Behavior of Values on Revisited Screens
Specify what this component does when a user enters a value, navigates to a previous screen, and then returns to the screen with this component.
Considerations
- The Choice Lookup flow screen component isn’t compatible with mobile devices or standalone Aura apps.
- The component searches for matches only in the Choice Label field of the Choice resource that you specify.
- Like other Choice fields, the Choice Lookup component supports the Was Selected operator.
- The search isn’t case-sensitive.
- Initially, 20 choice options display. As you scroll, more choice options load in groups of 100, up to the maximum of 1,020.
- If you apply a filter after loading your initial choices, the display resets, showing the new 20 choices.
- The Choice Lookup component doesn’t support the Display text input field for Choice resources. For example, if you select the Display text input checkbox when you configure a Choice resource and add the resource to the Choice Lookup component, the component doesn’t display a text input field when the user selects the corresponding choice at run time.

