Choice - Single

This form control is supported on Nintex Mobile in both online and offline modes.

Use the Choice - Single form control to allow users to make one selection from multiple options you have defined.

Note: You can arrange up to six of this control on a single row in the form.

To view video tutorials on how to use this Nintex capability, go to Nintex University

Section	Setting	Description
(unlabeled)	Title	Field name displayed on the published form.
	Customize	Switch toggle to Yes to enable customization of the variable Name of the form control.
	Name	(This field becomes configurable only when you switch the Customize toggle to Yes.) Customizes the name of the variable A placeholder that stores changes each time the workflow runs, such as the information entered in a form, or the name of a file. You can also create variables to store information you use in a workflow, such as an email address. for the field. If the name is not customized, the Title will be used as the variable name.
	Display type	Displays the user-selectable options using the selected type: Radio buttons (not recommended for displaying large data sets) Drop-down list
	Options	Options to display on the form. Click in this field, and then click Insert to launch the Formula builder where you can create and then insert a data variable with applied formulas, a collection, or a collection of objects. Video: Forms - Single Choice Control - data variable Usage Or, enter each option in a new line. You can include commas in the options, if required (for example, Melbourne, Victoria can be one option). You can also include pipes/vertical bars "\|" to define the options and their values (for example, Choice 1 \| 1234 can be one option where Choice 1 is the option's label and 1234 is the option's value). You can also add Rules to create business logic to pre-select options based on the option's value. This can help users more quickly complete forms and ensure data integrity before the form is submitted. When using rules with options, select the options entered in the control on the Rules tab.
Option configuration	Option label	(Displays when you insert a data variable with a collection in the Options field.) Displays selected option data to the form viewer.
	Option value	(Displays when you insert a data variable with a collection in the Options field.) Sends the corresponding selected value back to the workflow.
	Default value	The value that automatically populates the field when the form loads. Click in this field, and then click Insert to launch the Formula builder where you can create variables with applied formulas. The calculated value becomes the default value.
	Filter out duplicate options	Switch toggle to Yes to filter options by value regardless of their label. When this is enabled, if there are duplicate options, only the first option is displayed in the form. The filtered options may change due to dynamic data.
	Allow a fill-in option	(Displays when the display type is radio buttons.) Switch toggle to Yes to add "Other" option to enable users to type a custom option.
	Display 'Please select'	(Displays when the display type selected is Drop-down list.) Switch toggle to Yes to display the 'Please select' text in the drop-down list.
	Editable search term	(Displays when the display type selected is Drop-down list.) Switch toggle to Yes enable screen reading software to read out the control options, user selections and allow editing of the search term. With this enabled users can type text into the form control field. This is useful when you want form users to input any term they are searching for or when they want to copy specific words from long options. When typing, the options will be filtered according to the available options. The screen reading software will read out the labels, available options, and user selections made in the form control by the form user. Note: For the screen reader to work, the form user must have a supported built-in screen reader or a third-party screen reader application installed.
	Alignment	Orientation for display of the list of user-selectable options: Vertical Horizontal
	Required	Mandates entry of a value before the form can be submitted.
	Custom required message	(Displays when you select Yes in Required.) The validation text which displays below the field when a value is not entered into the field and the user attempts to change page or submit the form.
	Visible	Shows the field on the published form when loaded.
	Read-only	Displays the field on the published form but does not allow user input.
	Description	Helper text displayed below the field on the published form.
	Tooltip	The message which appears when users hover their cursor or touch the information icon beside the Choice - Single control in the form.
	Shrink	Reduces the width of the Single choice control in a row of other form controls.
	Expand	Increases the width of the Single choice control in a row of other form controls.
Styling	CSS class	Add a CSS class to apply a style to this form control. You can create the CSS class in the CSS code editor in form styles. Enter one class name or multiple class names separated by a space. For more information, see Add a custom CSS to individual controls. Note: The CSS Class field is available only if the Custom CSS setting is enabled in Nintex Automation Cloud Form settings.
	Border color	Border color to apply to the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style.
	Control Fill	The color to fill the inside of the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style.
	Control input color	The font color of the input in the field. To select a color, click the color box and use the color picker to specify the color you want. You can click on the color map to select the color or enter the Hex code. To revert back to the global style, click Reset to global style.