# `Backpex.Fields.MultiSelect`
[🔗](https://github.com/naymspace/backpex/blob/0.18.3/lib/backpex/fields/multi_select.ex#L2)

A field for handling a multi select with predefined options.

This field can not be searchable.

## Field-specific options

See `Backpex.Field` for general field options.

* `:options` - Required. List of possibly grouped options or function that receives the assigns.

* `:prompt` - The text to be displayed when no option is selected or function that receives the assigns.

* `:not_found_text` (`t:String.t/0`) - The text to be displayed when no options are found.

  The default value is `"No options found"`.

## Example

    @impl Backpex.LiveResource
    def fields do
      [
        users: %{
          module: Backpex.Fields.MultiSelect,
          label: "Users",
          options: fn _assigns -> [{"Alex", "user_id_alex"}, {"Bob", "user_id_bob"}] end
        },
      ]

# `config_schema`

Returns the schema of configurable options for this field.

This can be useful for reuse in other field modules.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
