Single Selector

The Single Selector block allows you to present users with a set of predefined options where only one option can be selected at a time. This keeps data structured and avoids errors from free-text fields. Single Selectors are useful when you want to enforce a clear choice, such as gender, role, department, or approval status.

In addition to simple lists, single selectors can also be linked together to create dependent (nested) selectors, where one selector’s options change based on what is to be selected in another.

Use Cases

• Standardised inputs: Choose from fixed values such as Gender, Yes/No, or Department.
• Guided choices: When users must pick only one option instead of multiple.
• Conditional logic: Trigger other fields or workflows depending on the selected value.
• Nested selectors: Configure multiple Single Selector blocks so that one field’s options depend on another (explained in detail below).

Editing the Block

When you add a Single Selector block and click on it, the right panel opens where you can configure it.

Label

The name of the field shown to users.
Example: “Select Gender” or “Approval Status.”

Description

Optional helper text displayed below the field. Use it to give instructions or leave it blank.
Example: “Select the appropriate category.”

Options

Add all the values you want users to choose from. Each option must be on a new line.
Example:

Yes  

No  

Maybe  

‍

Default Value

The option that should appear pre-selected when the form opens. Users can still change it before submitting.

Required

Enable this toggle if users must make a selection before they can submit.

Advanced Options

Dependency Fields (Nested Selectors)

This option allows you to create nested selectors, where the available choices depend on another field.

For example:

• Selector 1: Country → India, USA
• Selector 2: State → (India → Delhi, Mumbai; USA → New York, Chicago)
• Selector 3: City → (Delhi → Connaught Place, Mumbai → Andheri, etc.)

How to configure:

1. Create the first Single Selector (e.g., Country) and add its options.

2. Add the second Single Selector (e.g., State). In the Options box, format the values as:
   India||Delhi
   India||Mumbai
   USA||New York
   USA||Chicago

Then set the Dependency field to the Country field.

3. Add the third Single Selector (e.g., City). Format values as:
   
   India||Delhi||Connaught Place
   India||Mumbai||Andheri
   USA||New York||Manhattan
   USA||Chicago||Lincoln Park

Then set the Dependency fields to both Country (level 1) and State (level 2).

With this setup, the list in each selector dynamically updates based on the previous choice.

This is what it will look like in App Home:

Display this field if

Use this option to show or hide the field under specific conditions. It accepts the standard Clappia formulae, similar to conditional sections or in the ‘Calculations & Logic’ block.

1. Type @ to get a list of all the fields you have added in the app and select the relevant field or type @ followed by the field name.

2. Use these field variables to write spreadsheet-like formulae for conditional display of the field in the app.

Retain value if hidden

This option appears once a condition is set in the Display this field if option. Enable this setting if you want the field's value to be retained even when the field is hidden. This is useful for preserving user input in cases where the field may temporarily disappear based on conditions.

Example: If the field is hidden based on user selection but you still need to keep the entered value for future reference or calculations, enable this option to ensure the data is retained.

Allow Value to Be Changed After Initial Submission

This option is enabled by default.

• If this toggle is on: users can edit their choice after submitting by navigating to the Submissions tab. You can also give conditions on when the submissions can be edited by typing it in the box below the toggle.
  

• If this toggle is off: the value becomes locked after submission and cannot be changed.

Style

Change the appearances of the options as Chips or Standard.

Chips View:

Standard View:

‍

‍

‍

Block Width (Desktop and Mobile)

Adjust how wide the selector appears on screen:

• Desktop: 100%, 75%, 50%, 25%
  
• Mobile: 100% or 50%

Variable Name

After saving your configuration, the system automatically assigns a Variable Name to the dropdown field. This variable name is used when:

• Writing formulas,
• Creating workflow conditions,
• Designing PDFs,
• Or when referring to this field in other app blocks.

You can change the variable name to something short and meaningful.