Loading
Salesforce now sends email only from verified domains. Read More
Automate Your Business Processes
Table of Contents
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

          Search all of Salesforce Help
          Choice Lookup Screen Input Component

          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 {!choiceLookup.selectedChoiceLabels}.

          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 {!choiceLookup.selectedChoiceValues}.

          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:

          Always
          Always display the component.
          When all conditions are met (AND)
          Display the component when all of the conditions that you define are met. Define at least one condition.
          When any condition is met (OR)
          Display the component when at least one of the conditions that you define is met. Define at least one condition.
          When custom conditional logic is met
          Display the component when the condition logic that you define is met. Define at least one condition and specify condition logic.

          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.

          Option Description
          Use values from when the user last visited this screen The component retains the values that the user specified and doesn’t update the values to reflect changes made on previous screens.
          Refresh inputs to incorporate changes elsewhere in the flow

          The component updates the user-specified values to reflect changes made on previous screens.

          If you pause and then resume the flow, the flow retains user-specified values only in Checkbox, Checkbox Group, Currency, Long Text Area, Multi-Select Picklist, Number, Password, Picklist, Radio Buttons, and Text components.

          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.
           
          Loading
          Salesforce Help | Article