---
schema_version: "1"
id: 0d3b0c57c0c84960835339c717f36f930f78f6bed0f1140e088528cbe8bfc947
title: Picklist 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_picklist.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.flow_ref_elements_screencmp_picklist.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 0785f81febebf0e972b627e8e98b5abfcad7b3270c5f699c8614babb95165d97
description: Let users choose from a list of options in a picklist format.
products:
  - Flow Builder
  - Salesforce Platform
release: "264"
---
# Picklist Screen Input Component

Let users choose from a list of options in a picklist format.

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

Starting with Flow Run-time API version 52, the first option listed for all picklists is --None--. If you don’t set a default value for a picklist in Flow Builder, the --None-- option is automatically selected at run time. --None-- is treated as a null value. If you set the picklist as required and the user selects --None--, then the flow run time prevents the user from proceeding to the next screen.

## Configure the Picklist 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="d319873e74">Attribute</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d319873e77">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Attribute" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e74 ">
              <strong class="uicontrol">API Name</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">
              <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="d319873e74 ">
              <strong class="uicontrol">Choice</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">
              <p>Add at least one choice, record choice set, or picklist
                choice set to this component. Available only when you add a choice component to
                the screen component. In all screen components except Display Text components, the
                choice's value is used at runtime. </p>
              <p style="margin-bottom:0;">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>
            </td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">
              <p dir="ltr">Modify a choice component type.</p>
              <p dir="ltr">If the user can select only one option, these component types become
                available:</p>
              <ul>
                <li>Picklist</li>

                <li>Radio Buttons</li>

              </ul>
              <p dir="ltr">If the user can select multiple options, these component types become
                available:</p>
              <ul>
                <li>Checkbox Group</li>

                <li>Multi-select Picklist</li>

              </ul>
            </td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">
              Controls which choices are available for this component. For example, if you choose
              Number, you can’t select a Text choice. </td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">
              <p>
                <span>Controls the number
                  of digits to the right of the decimal point up to 17 places. If you leave this field blank
                  or set it to zero, only whole numbers appear when your flow runs.</span>
              </p>
              <p style="margin-bottom:0;">
                <span>Available only when the data type is Number or Currency.</span>
              </p>
            </td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">
              <span>Pre-selected choice for the
                component. If the associated screen isn’t run or the conditions for component
                visibility aren’t met, the stored value of the component is
                <code>null</code>.</span>
            </td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">
              <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="d319873e74 ">
              <strong class="uicontrol">Label</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">The text that appears with the screen
              component that tells the running user how to use it.</td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">Specifies
              whether the user can choose only one option or multiple options. When you select Yes
              for Let Users Select Multiple Options, Data Type is automatically set to Text, and
              non-text Choice resources are cleared from the component configuration.</td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">Give your users more context with
              this screen component. The text you enter is available in an info bubble next to the
              component.</td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e77 ">
              <span>Requires users to select a value
                before they can move to the next screen.</span>
            </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="d319873e300">Option</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d319873e303">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e300 ">
              <strong class="uicontrol">When to Display Component</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e303 ">
              <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="d319873e391">Option</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d319873e394">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Option" class="slds-cell-wrap" style="vertical-align:top;" headers="d319873e391 ">
              <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="d319873e394 ">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="d319873e391 ">
              <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="d319873e394 ">
              <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_picklist__d5707e119"><a name="flow_ref_elements_screencmp_picklist__d5707e119"><!-- --></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

- A Picklist component can have up to 500 choices.
- Rich text isn’t supported in the Picklist component.
- The Picklist component doesn't show text between the < and > characters.

#### See Also

- [Standard Flow Screen Components](https://help.salesforce.com/s/articleView?id=platform.flow_ref_elements_screencmp.htm&release=264.0.0&type=5 "Salesforce provides several standard screen components that extend the types of input fields available in screens.")