--- title: "Single Choice" slug: "single-choice-1" updated: 2024-10-22T12:32:03Z published: 2024-10-22T12:32:03Z canonical: "help.symphonysummitai.com/single-choice-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.symphonysummitai.com/llms.txt > Use this file to discover all available pages before exploring further. # Single Choice The Single Choice control is used to make a single selection on a form. It can be displayed as a drop-down or as multiple chips. and the selected option will be displayed in the search text box. A sample screenshot is shown below: ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1677756660257.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Single Choice Control - Drop-Down Let's explore the following use-case. | **Use Case** **User Persona: Application Designer** | **Solution** | | --- | --- | | The Application Designer Sam wants to create an interface for their application where he can convert an SR to an Incident with the following two scenarios: - The SR is cancelled automatically when the Incident is created. - The SR is resolved automatically when the Incident is created. Also, he should have the flexibility to make this functionality available on either on New Incident page or New Incident for User page. | To achieve the first functionality, he can drag and drop the Single Choice control on the Form page. Configure the control with labels as **Auto Cancel Service Request** and **Auto Resolve Service Request** in chip format. To achieve the second functionality, configure the control in drop-down format with options as **New Incident** and **New Incident for Use****r**. | Let's explore the following use-case. | **Use Case** **User Persona: Application Designer** | **Solution** | | --- | --- | | The Application Designer Sam wants to create an interface for their application where he can display the list of all available Tenants such as Information Technology, Human Resources, It Operations and Hardware for a specific module. He should be able to select one of the required options from the list. | To achieve this, he can drag and drop the Single Choice control on the Form page. Configure the control with label as **Tenant.** Render it as drop-down and configure the options of the drop-down list as **Information Technology, Human Resources and IT Operations**. | ## Configure Single Choice Control Let's configure Single Choice Control! 1. Navigate to **General** tab of Form Designer. Enter all mandatory details required for the Form. 2. In **Design Form** tab, from the left pane select **Controls** > **Form Controls** > **Single** **Choice**. Drag and drop this control inside a panel to create a multi choice field. Click Settings icon to view Properties pop-up. You can view the following tabs for Singe Choice control: ### Properties This section contains the list of properties using which the Administrator can configure the respective control's name, subtitles etc. To know more about the fields that are available under the **Properties** section, see Field Description given below.![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1677740358836.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Properties **Field Description** This table contains the list of fields and their descriptions that are available under the **Properties** section: | **Field** | **Description** | | --- | --- | | General | | | Title | Specify the name for the Single Choice control. This name identifies the Single Choice control in the form. *For Example: Email Notification for Incident* | | Subtitle | Specifies the text which you want to display just beneath the control. You may use it to describe the purpose of the control or the way it should be used etc. For Example: As shown in the following screenshot "Send email notification for incident status update" is the subtitle for the Single Choice control named "Incident Status Email Notification". ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1663330873911.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Subtitle | | Render As | The Single Choice control can be rendered as one of the following available options: - As Status - As Sub Status - As Tenant | | Render Type | The Single Choice control can be rendered as one of the following types. Available options are as follows: - Chip - It displays the selectable options in a specific scenario. - Dropdown - It displays the drop-down list of various options. | | Hide Label | If this toggle button is enabled, then the configured label will not be displayed on the form. | | Informative | | | Help Text | Displays the information about the UI control in the form in a textual format to guide the user. | | Rich Text | Select it to enable the text as rich text format and interpret as rich text. | | Tooltip | Displays the information about the UI control in the form in the tooltip format to guide the user. The tooltip is displayed when the user hovers the mouse cursor over the control. | ### Advance This section contains the advance section To know more about the fields that are available under the **Advance** section, see Field Description given below. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1677740477231.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Advance **Field Description** This table contains the list of fields and their descriptions that are available under the **Advance** section: | **Field** | **Description** | | --- | --- | | General | | Include as Filter | If this toggle button is enabled, then the respective control is available as a filter option on the Form Designer list page of the application. | | Include as a column in grid view | If this toggle button is enabled, then the respective control is available as a column on the Form Designer list page of the application. | | Is Clickable | If this toggle button is enabled, then the respective control is clickable. | | Show Clear Icon | If this toggle button is enabled, then a cross mark (x) is displayed against all the drop-down values selected from the respective control using which the user can clear the individual value. | ### Validations This section contains the list of validation setups using which the Application Designer can configure the respective control as mandatory, based on condition, and so on. To know more about the fields that are available under the **Validations** section, see Field Description given below. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1677740649988.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)Figure: Validations **Field Description** This table contains the list of fields and their descriptions that are available under the **Validations** section: | **Field** | **Description** | | --- | --- | | Title should be | Select one of the following options as per your requirement: - Mandatory - Select the Mandatory from the drop-down to make the control as mandatory control. - Disabled - Select the Disabled from the drop-down to make the control as disabled control. - Hidden - Select the Hidden from the drop-down to make the control as hidden control. - Editable - Select the Editable from the drop-down to make the control as editable control - Unique - Select the Unique from the drop-down to make the control as unique control. | | Below Conditions Meet | Select it if you want to display this control based on certain conditions. The following fields are displayed to configure the conditions: **Field** - Select the field from the drop-down list on which the condition is to be applied. **Operator** - Select the required operator from the displayed drop-down list. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1663332815229.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)Figure: Validations Use ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1672041195465.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)icon to add more conditions. | | Every Time | Select it if you want to display this control always without any specific conditions or validations. | ### Appearance This section contains the appearance setups using which you can configure the look and feel of the respective control such as font type, color, size and so on. To know more about the fields that are available under the **Appearance** section, see Field Description given below. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1677740880337.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Appearance **Field Description** This table contains the list of fields and their descriptions that are available under the **Appearance** section: | **Field** | **Description** | | --- | --- | | Text | | | Font Type | Select the type of the font from the drop-down list of available options of font type. | | Font Color | Select the type of the font color from the color widget from the provided set of color options. Click ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1678444957448.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) option to select the required color from the displayed color widget. A sample screenshot is shown below: ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1678445276112.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)Figure: Color Widget | | Font Size | Select the size of the font from the drop-down list of available options of font type using upwards or downwards arrows. A sample screenshot is shown below: ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1678445390752.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Font Size Drop-down You can also use a horizontal slider to increase or decrease the font size. A sample screenshot is shown below: Figure: Font Size Slider | | Font Style | Select the type of the font from the drop-down list of available options of font type. | ### Security This section contains the security measures that can be configured for the respective control. It will allow you to control the form usage based on the restricted configured access. Configure view and edit permissions at the field level.![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1677740946312.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)Figure : Security For more information on Security tab, refer [here](https://help.symphonysummitai.com/summit-platform/docs/form-security). ### Data Source This section contains the data source details. To know more about the fields that are available under the **Data Source** section, see Field Description given below. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1677741038092.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Data Source - Table The following screenshot is displayed if the Data Source is selected as API.![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1672300630075.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Data Source - API The following screenshot is displayed if the Data Source is selected as Manual. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1685020637660.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Data Source - Manual The following screenshot is displayed if the Data Source is selected as Status. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1672300789014.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Data Source - Status This section contains the list of fields and their descriptions that are available under the **Data Source** section. To know more about the fields that are available under the **Data Source** section, see Field Description. | **Field** | **Description** | | --- | --- | | Data Source | Select one of the following options to select the data source. Available options are as follows: - Manual - Table - API - Status | | Parent | If selected, the control will take the data from the parent table. For Example: If you create a multi-choice control named **State**, then the Parent Data Source for this can be **Country** table. | | Is Parent Encrypted ? | If selected, then the Parent field value is encrypted at database level to maintain the security. Example: If **Parent** field is SSN of a citizen and it needs to be secured at database level, enable **Is Parent Encrypted** button. | | Origin | This field is visible only if **Data Source** is selected as **API**. Select the origin for the API request. Available options are as follows: Same Origin - Select it if the API request is from same origin. Cross Origin - Select it if the API request is from different origin. For Example: **Scenario I** Origin I = https://www.acme.com/222 Origin 2= https://www.acme.com/111 In this case, Origin I and Origin 2 are same Origin. **Scenario II** Origin I = https://www.acme.com/222 Origin II = https://www.example.com/222 [](https://www.acme.com/222)In this case, Origin 1 and Origin 2 are cross Origin. | | Type | This field is visible only if **Data Source** is selected as **API**. Select the type of the API. Available options are as follows: Get - Select it to fetch data from a specified resource. Post - Select it to send data to update a resource. | | Address | This field is visible only if **Data Source** is selected as **API**. Specify the API URL. | | Parameters | This field is visible only if **Data Source** is selected as **API**. Select the Parameters from the drop-down list. | | Label Field | Label is the text that appears to the user for that choice. Use short phrases in your choice lists. | | Value Field | Value is a string that is stored in the variable when that choice is selected. | | Body | This field is visible only if **Data Source** is selected as **API**. | | Font Color | This field is available when the **Data Source** only if the Data Source is selected as **Manua****l**. Click on the colored box under Font Color to select the required color for the respective configured status text. | | Background | This field is available only if the **Data Source** is selected as **Manua****l**. Click on the colored box under Background to select the required color for the respective configured status background. | | Default | This field is available only if the **Data Source** is selected as **Manua****l**. Enable it to make the respective status as default status. | | System Staus | This field is available only if the **Data Source** is selected as **Manua****l**. Map the manual status values with system status. Select one of the options available under **System Status** drop-down to map it with corresponding manual status. The available options are as following: - New - In-Progress - Resolve - Closed - Cancelled | | Status Transition | This field is available only if the **Data Source** is selected as **Manua****l**. Configure the future status values to move the status from one status to another. Select the options available under **Transition Status** drop-down to configure the status to which the manual status can be moved to as per requirement. **Case I - Sequential** When only one manual value is added, the Transition Status drop-down does not display any option. When two manual values are added, the Transition Status drop-down displays the first manual value in the option list. Similarly, once the manual status is added, correspondingly **Transtition** **Status** drop-down displays all manual values as options before the current value. The following depicts the above case. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1685086246109.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)Figure: Sequential - Transition Status **Case II - Refer Back** In this case all added manual values are displayed in the Status Transition drop-down except the current value. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1685086754754.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D) Figure: Refer Back - Transition Status When the Transition Status is not configured, the consumer will not have option to move from one status to another. Also, the records for which the Transition Status is not configured will be in display mode or read only mode. For Example - For the manual status **Closed**, the **Transition Statu****s** is not configured and hence the consumer will not have any option to change the status from **Closed** to any other status. | | Active | This field is available only if the **Data Source** is selected as **Manua****l**. Enable it if you want to display the status as one of the columns on list page. | | Actions | The following actions are available: ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1672301152382.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)Use it to drag up or down to reorder the labels. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1672301210913.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)Use it to disable a label. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1672301233841.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)Use it to add more labels. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-1672301463941.png?sv=2026-02-06&spr=https&st=2026-10-31T14%3A46%3A16Z&se=2026-10-31T15%3A46%3A16Z&sr=c&sp=r&sig=QB9tmEUIZ6nyunlp5Mwhj99IO%2BDyYYMdqubanBvUBWc%3D)Use it to delete any label. |