Skip to content

Lets respondents choose more than one option from a list. Supports min/max selection limits, ordering, and default values.

See the Multiple Selection field help article for builder options.

Schema

FieldTypeDescription
choice.subType"multiplechoice"Multi-select checkboxes
choice.optionsarrayList of choices, each with text and _id
choice.minnumberMinimum number of options that must be selected
choice.maxnumberMaximum number of options that can be selected
choice.otherbooleanShow an "Other" option
choice.defaultValuestring[]Pre-selected option IDs
choice.isOrderbooleanPreserve the defined option order (disable shuffle)
choice.shuffleOptionsbooleanRandomize option order for each visitor
{
  "_id": "6a0ef6b13affac35058b05ec",
  "questionType": "choice",
  "question": "Multiple choice question",
  "displayOrder": 7,
  "isRequired": false,
  "isDeleted": false,
  "isActive": false,
  "description": "Multiple choice question helper text",
  "choice": {
    "subType": "multiplechoice",
    "min": 2,
    "max": 3,
    "other": false,
    "options": [
      { "text": "Option 1", "_id": "6a0ef6b13affac35058b05ea" },
      { "text": "Option 2", "_id": "6a0ef6cf3affac35058b0634" },
      { "text": "Option 3", "_id": "6a0ef6d23affac35058b0635" }
    ],
    "defaultValue": ["6a0ef6cf3affac35058b0634"],
    "isOrder": true,
    "shuffleOptions": false,
    "_id": "6a0ef771a7a40272efec2aac"
  }
}