> From the [Strife developer docs](https://strife.app/docs/reference/fields/multi-select). Every page is listed in [llms.txt](https://strife.app/docs/llms.txt).

# Multi Select

The Multi Select field allows, just like the Combo Box, users to add one or more values of a predefined list, storing them as an array in the database.

<figure><img src="https://strife.app/docs/assets/Screenshot%202023-10-27%20at%2010.46.09.png" alt="" width="375"><figcaption><p>Strife Studio screenshot of an Multi Select field</p></figcaption></figure>

### Settings

In addition to the basic settings, this section provides information about unique settings and configurations specific to this field.

> [!NOTE]
> You can find a comprehensive list of all basic settings in the ['Overview' section](https://strife.app/docs/reference/fields.md).

<table><thead><tr><th width="232">Option</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Placeholder</td><td>Display a placeholder text in the search field after opening the combo box</td><td></td></tr><tr><td>Check marks</td><td>Enables check marks on the selected values</td><td></td></tr><tr><td>Options</td><td>Defines the choices presented in the drop-down. Each option is represented as an object containing a name, value, and color hex value (optional)</td><td></td></tr></tbody></table>

### Define with JSON

When defining templates using JSON, this field is represented using:

* **Component Name:** `str-multi-select`
* **Type:** `multi-select`
* Reference ID: `str-multi-select`

The settings above map into the `editor.attributes` object inside the JSON definition.

```json
{
  ...
  "editor": {
    "name": "str-multi-select",
    "type": "multi-select",
    "propertyName": "...",
    "attributes": {
      "placeholder": "...",
      "switches": true,      //Check marks
      "externalDataSource": "..."     
    },
    "options": {
      "options": [
        {
          "name": "...",
          "value": "...",
          "color": "...",  //Optional, hex color format
          "icon": "...",   //Optional, name of icon
          "avatar": "..."  //Optional, url to avatar
        },
        ...
      ]
    }
  },
  ...
}
```

### Live preview

> [!NOTE]
> This field does not have any default Strife Web Components. Custom live preview implementations are fully supported.

> [!NOTE]
> For more information on live preview and Strife Web Components, please refer to the [Live preview documentation](https://strife.app/docs/reference/live-preview.md).