Dropdown Question Schema Properties
A question that presents choices in a dropdown menu for single selection.
Element type: dropdown
Key properties: 20
Generation Hints
Section titled “Generation Hints”- Aliases: select, select list, single-select dropdown.
- Use when: respondents choose one option from a compact list.
- Recommended properties:
type,name,title,choices,choicesByUrl,placeholder,isRequired.
{ "type": "dropdown", "name": "department", "title": "Department", "choices": ["Sales", "Support", "Operations"] }Key Properties
Section titled “Key Properties”choices
Section titled “choices”- Type:
choiceitem[] - Default:
[]
Gets or sets choice items. This property accepts an array of objects with the following structure:
choicesByUrl
Section titled “choicesByUrl”- Type:
restfull - Default:
—
Configures access to a RESTful service that returns choice items. Refer to the ChoicesRestful class description for more information. You can also specify additional application-wide settings using the settings.web object.
choicesFromQuestion
Section titled “choicesFromQuestion”- Type:
question_carryforward - Default:
—
Copies choice items from a specified question. Accepts a question name.
choicesFromQuestionMode
Section titled “choicesFromQuestionMode”- Type:
string - Default:
"all" - Allowed values:
all,selected,unselected
Specifies which choice items to copy from another question. Applies only when the choicesFromQuestion property is specified.
choicesVisibleIf
Section titled “choicesVisibleIf”- Type:
condition - Default:
—
A Boolean expression that is evaluated against each choice item. If the expression evaluates to false, the choice item becomes hidden.
choicesEnableIf
Section titled “choicesEnableIf”- Type:
condition - Default:
—
A Boolean expression that is evaluated against each choice item. If the expression evaluates to false, the choice item becomes read-only.
choicesOrder
Section titled “choicesOrder”- Type:
string - Default:
"none" - Allowed values:
none,asc,desc,random
Specifies the sort order of choice items.
allowClear
Section titled “allowClear”- Type:
boolean - Default:
true
Specifies whether to display a button that clears the selected value.
allowCustomChoices
Section titled “allowCustomChoices”- Type:
boolean - Default:
false
Specifies whether users can add their own choices if the desired option isn’t available in the dropdown.
placeholder
Section titled “placeholder”- Type:
string - Default:
— - Localizable: Yes
A placeholder for the input field.
searchMode
Section titled “searchMode”- Type:
string - Default:
"contains" - Allowed values:
contains,startsWith
Specifies a comparison operation used to filter the drop-down list. Applies only if searchEnabled is true.
hideIfChoicesEmpty
Section titled “hideIfChoicesEmpty”- Type:
boolean - Default:
—
Specifies whether to hide the question if no choice items are visible.
showOtherItem
Section titled “showOtherItem”- Type:
boolean - Default:
—
Specifies whether to display the “Other” choice item.
showNoneItem
Section titled “showNoneItem”- Type:
boolean - Default:
—
Specifies whether to display the “None” choice item.
showCommentArea
Section titled “showCommentArea”- Type:
switch - Default:
—
Specifies whether to display a comment area.
otherText
Section titled “otherText”- Type:
string - Default:
— - Localizable: Yes
Gets or sets a caption for the “Other” choice item.
otherPlaceholder
Section titled “otherPlaceholder”- Type:
string - Default:
— - Localizable: Yes
A placeholder for the comment area. Applies when the showOtherItem or showCommentArea property is true.
noneText
Section titled “noneText”- Type:
string - Default:
— - Localizable: Yes
Gets or sets a caption for the “None” choice item.
dontKnowText
Section titled “dontKnowText”- Type:
string - Default:
— - Localizable: Yes
Gets or sets a caption for the “Don’t know” choice item.
refuseText
Section titled “refuseText”- Type:
string - Default:
— - Localizable: Yes
Gets or sets a caption for the “Refuse to answer” choice item.
Shared Properties
Section titled “Shared Properties”This page lists only properties that are specific to this element type or especially important for generation.
- Use Shared Question Properties for common fields such as
name,title,description,isRequired,requiredIf,visibleIf,enableIf,readOnly,defaultValue,validators,width, and layout options. - Use Shared Choice Question Properties for shared choice fields such as
choices,choicesByUrl,choicesFromQuestion,showOtherItem,showNoneItem, and special choice labels. - Use Choice Item for object choices and Choices By URL for remote choice loading.