You are here:
Choice Resource
Create a choice option for a screen component, such as a Radio Buttons or Multi-Select Picklist component.
Required Editions
| View supported editions. |
| Field | Description |
|---|---|
| API Name | 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. |
| Description | Helps you differentiate this choice from other resources |
| Choice Label | A user-friendly label for the choice. This text is what's used to represent the choice in display text screen components and text formula resources. |
| Data Type | 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. |
| Choice Value | If the user selects this choice, the screen component is set to this value. Exceptions:
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. |
| Display text input | Displays a text input component below the choice. This option isn’t available
if the choice’s data type is Boolean. |
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. |
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. |
