---
schema_version: "1"
id: 5c313290692b734e208bd4a72d8010f28ad5f62b3c8a4a7415ed8da965a0b40b
title: Choice Lookup Screen Input Component
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/flow_ref_elements_screencmp_choice_lookup.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.flow_ref_elements_screencmp_choice_lookup.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 2b10e3c3291717d8fe21d7bdef9cf71c486e0cbce09675aa9c54c4459ed9d0c6
description: Let users search for and select one option from a set of choices on a flow screen. The component supports only Text values.
products:
  - Flow Builder
  - Salesforce Platform
release: "264"
---
# 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

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=platform.flow_ref_supported_editions.htm&amp;release=264.0.0&amp;type=5" title="Learn about the editions and user interfaces that support Flow Builder. Some Flow Builder features integrate with other Salesforce products that require additional licenses.">View supported editions.</a></td></tr></tbody></table>

## Configure the Choice Lookup Component

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:24%">
          <col style="width:76%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d250594e65">Attribute</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d250594e68">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e65 ">
              <strong class="uicontrol">Label</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e68 ">User-friendly text that appears above the component.</td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e65 ">
              <strong class="uicontrol">API Name</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e68 ">
              <p>The API name of the component.</p>
              <p style="margin-bottom:0;">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.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e65 ">
              <strong class="uicontrol">Require</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e68 ">
              <span>Requires users to select a value
                before they can move to the next screen.</span>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e65 ">
              <strong class="uicontrol">Disabled</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e68 ">
              <p>If set to true, the user can’t
                modify the value. The default value is false.</p>
              <p style="margin-bottom:0;">This attribute accepts a resource
                with a Boolean value.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e65 ">
              <strong class="uicontrol">Placeholder Text</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e68 ">
              <p>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.</p>
              <p style="margin-bottom:0;">This attribute accepts a resource with a single value. The value is
                treated as text.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e65 ">
              <strong class="uicontrol">Let Users
                Select Multiple Options</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e68 ">Specifies whether the user can choose only one option or multiple options. The user
              can select up to 25 options.</td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e65 ">
              <strong class="uicontrol">Choice</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e68 ">
              <p>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.</p>
              <p>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.</p>
              <p style="margin-bottom:0;">You can’t reorder choices or select the same choice twice. Choices must be compatible
                with the component’s <strong class="uicontrol">Data Type</strong> setting.</p>
            </td>

          </tr>
        </tbody>
      </table>

## 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.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:24%">
          <col style="width:76%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d250594e204">Attribute</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d250594e207">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e204 ">
              <strong class="uicontrol">selectedChoiceLabels</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e207 ">
              <p>If users can select only one option, the label of the choice option that the user
                running the flow selected.</p>
              <p>If users can select multiple options, the semi-colon separated
                labels of all the choice options the user running the flow selected.</p>
              <p style="margin-bottom:0;">Reference the
                value later in the flow as <code>{!choiceLookup.selectedChoiceLabels}</code>.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e204 ">
              <strong class="uicontrol">selectedChoiceValues</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e207 ">
              <p>If users can select only one option, the value of the choice option that the user
                running the flow selected.</p>
              <p>If users can select multiple options, the semi-colon separated
                values of all the choice options the user running the flow selected.</p>
              <p style="margin-bottom:0;">Reference the
                value later in the flow as <code>{!choiceLookup.selectedChoiceValues}</code>.</p>
            </td>

          </tr>
        </tbody>
      </table>

## Set the Component Visibility

Specify the logic that determines when the flow displays the component.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:24%">
          <col style="width:76%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d250594e276">Option</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d250594e279">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e276 ">
              <strong class="uicontrol">When to Display Component</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e279 ">
              <p>Configure when the component is displayed by using conditional logic. </p>
              <p>You can set the components to:</p>
              <dl>

                <dt style="font-weight:bold;padding-top:.25rem;">Always</dt>

                <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Always display the component.</dd>


                <dt style="font-weight:bold;padding-top:.25rem;">When all conditions are met (AND)</dt>

                <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Display the component when all of the conditions that you define are met.
                  Define at least one condition.</dd>


                <dt style="font-weight:bold;padding-top:.25rem;">When any condition is met (OR)</dt>

                <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Display the component when at least one of the conditions that you define is
                  met. Define at least one condition.</dd>


                <dt style="font-weight:bold;padding-top:.25rem;">When custom conditional logic is met</dt>

                <dd style="padding-left:1.5rem;padding-bottom:.5rem;">Display the component when the condition logic that you define is met.
                  Define at least one condition and specify condition logic.</dd>

              </dl>
            </td>

          </tr>
        </tbody>
      </table>

## 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.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:24%">
          <col style="width:76%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d250594e367">Option</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d250594e370">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e367 ">
              <strong class="uicontrol">Use values from when the user last visited this screen</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e370 ">The component retains the values that the user specified and doesn’t update the
              values to reflect changes made on previous screens.</td>

          </tr>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e367 ">
              <strong class="uicontrol">Refresh inputs to incorporate changes elsewhere in the flow</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d250594e370 ">
              <p>The component updates the user-specified values to reflect changes made on
                previous screens.</p>
              <p style="margin-bottom:0;" id="flow_ref_elements_screencmp_choice_lookup__d4975e119"><a name="flow_ref_elements_screencmp_choice_lookup__d4975e119"><!-- --></a>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.</p>
            </td>

          </tr>
        </tbody>
      </table>

## 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.

#### See Also

- [Choose a Lookup Option for a Flow Screen](https://help.salesforce.com/s/articleView?id=platform.flow_ref_elements_screencmp_lookup_comparison.htm&release=264.0.0&type=5 "Salesforce provides three ways for users to search for and select records on flow screens. Generally, use the Lookup component when you want users to search an unfiltered list of records. Use the Choice Lookup component when you want users to search a filtered list of records or static choices. Use a lookup record field when you want users to have the option to create a record from the lookup field. This table describes the differences between the three options.")