---
schema_version: "1"
id: 7cfe7ce044db7ec67b22387eb386bb840f561463aa05b2001b9c911628ff0f94
title: Choice Resource
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/flow_ref_resources_choice.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.flow_ref_resources_choice.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 79728953db389573490fe46f72d18d1872c40527bf38fd5550f45717d376e0dd
description: Create a choice option for a screen component, such as a Radio Buttons or Multi-Select Picklist component.
products:
  - Flow Builder
  - Salesforce Platform
release: "264"
---
# Choice Resource

Create a choice option for a screen component, such as a Radio Buttons or Multi-Select Picklist component.

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

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:21.186440677966097%">
          <col style="width:78.81355932203388%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d336275e62">Field</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d336275e65">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d336275e62 ">
              <strong class="uicontrol">API Name</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d336275e65 ">
              <span>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.</span>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d336275e62 ">
              <strong class="uicontrol">Description</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d336275e65 ">Helps you differentiate this choice from other resources</td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d336275e65 ">
              <p>A user-friendly label for the choice. </p>
              <p style="margin-bottom:0;">This text is what's used to represent
                the choice in display text screen components and text formula
                resources.</p>
            </td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d336275e65 ">Controls which screen components this choice can be used in. For example, you
              can’t use a Text choice in a Currency radio button. You can’t change the data type
              of a previously saved choice.</td>

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

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d336275e65 ">
              <p>If the user selects this choice, the screen component is set to this
                value.</p>
              <p>Exceptions:</p>
              <ul>
                <li>If no choice value is configured, the screen component is set to a null
                  value.</li>

                <li>If the choice value references a formula resource, the screen component is set
                  to the resolved choice value.</li>

              </ul>
              <p style="margin-bottom:0;">This text is what's used to represent the choice in all screen components
                except display text screen components and all types of formula resources except
                text formula resources.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d336275e62 ">
              <strong class="uicontrol">Display text input</strong>
            </td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d336275e65 ">Displays a text input component below the choice. This option isn’t available
              if the choice’s data type is <code>Boolean</code>.</td>

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

## Choice Value vs. Choice Label Used at Runtime

 
| Where | Which Is Used |
| --- | --- |
| In all screen components except Display Text components. | Value |
| In all resources except text Formulas. | Value |
| Display Text components | Label |
| Text Formula resources | Label |

## Configure Text Input

These fields appear when you select **Display text input**.

 
| Field | Description |
| --- | --- |
| **Input Label** | A user-friendly label for the text input component |
| **Require** | Requires the user to enter a value in the text input component before progressing or finishing the flow |
| **Validate** | Evaluates whether the user entered an acceptable value |
| **Error Message** | If the user didn’t enter an acceptable value, this message displays under the text input component. Available only when Validate is selected. |
| **Formula** | Boolean formula expression that evaluates whether the user entered an acceptable value. Available only when Validate is selected. |

![Example](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-264-0-0-production-enus/60568438-ec7e-4665-acd1-7c80dcbe60d5/images/icon_example.png)

Example To let users choose a particular service level, create choices for Gold, Silver, and Bronze. In a screen, display the choices with a description of the features included. Then, in the same screen, let the user choose from a Radio Buttons screen component.

## Formatting Choices

- Add rich text formatting by using the toolbar.
- Choice Lookup and Visual Picker display plain text labels for your choices. They don’t show any rich text formatting applied to the choice labels in the choice resources.
- If you open the Display Text screen component, Choice resource labels, help text, Pause confirmation screens, or input validation, Flow Builder converts existing HTML to rich text. Unsupported HTML is removed. The following HTML tags are converted to rich text: <a>, <b>, <br>, <font>, <i>, <li>, <p>, <span>, <u>, and <div>. HTML that is pasted into the rich text editor isn't supported.

## Customize User Interface

Add Salesforce Lightning Design System icons to choice resources. Familiar icons make it easier for users to make selections by looking at the icons instead of reading the accompanying text.

 
| Click | to |
| --- | --- |
| Choose Icon | Choose an icon from the Utility, Doctype, or Standard icons. You can also search for an icon. To view all the available Utility, Doctype, and Standard Salesforce Lightning Design icons, see [Icons](https://summer-20.lightningdesignsystem.com/icons/). |

#### See Also

- [Flow Resources](https://help.salesforce.com/s/articleView?id=platform.flow_ref_resources.htm&release=264.0.0&type=5 "Each resource represents a value that you can reference throughout the flow.")
- [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.")
- [Choosing Which Choice Resource to Use in Screen Components](https://help.salesforce.com/s/articleView?id=platform.automate_flow_build_using_choice_resources_with_flow_screen_components.htm&release=264.0.0&type=5 "Choice resources display selectable options in flow screens. Choice resources can appear as radio buttons, checkboxes, or picklist fields. There are several options for choice resources that you can use, depending on your business need. We recommend using a choice resource only when you can’t use a record choice set or a picklist choice set.")
- [Help Users Select Faster by Using Visual Cues in Choices](https://help.salesforce.com/s/articleView?id=platform.automate_flow_build_help_users_select_faster_by_using_visual_cues_in_choices.htm&language=en_US)