# Multiple selection

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

See the [Multiple Selection field](https://forms.app/en/help-center/multiple-selection) help article for builder options.

## Schema

| Field | Type | Description |
|  --- | --- | --- |
| `choice.subType` | `"multiplechoice"` | Multi-select checkboxes |
| `choice.options` | array | List of choices, each with `text` and `_id` |
| `choice.min` | number | Minimum number of options that must be selected |
| `choice.max` | number | Maximum number of options that can be selected |
| `choice.other` | boolean | Show an "Other" option |
| `choice.defaultValue` | string[] | Pre-selected option IDs |
| `choice.isOrder` | boolean | Preserve the defined option order (disable shuffle) |
| `choice.shuffleOptions` | boolean | Randomize option order for each visitor |


```json
{
  "_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"
  }
}
```