# MultiSelect Custom Values

The MultiSelect component lets users type their own values that are not part of the options predefined by the developer.

The text entered by the user can still go into the collection that MultiSelect component is bound to through two-way binding.

To enable custom user input, set the `AllowCustom` parameter to `true`. When the user types a custom value, it appears as the first item in the list with the label: `Use "typed value"`. The user must select (click) the value, to actually add it the collection of values that MultiSelect is bound to. Refer to the example below to see the feature in action.

> When custom values are enabled, the `TextField`, `ValueField` and the `Value` must be of type `string`. Otherwise an exception will be thrown. Strings are required because the user input can take any form and may not be parsable to other types (such as numbers or GUID).

When custom input is allowed, the [`ValueChanged` event](https://www.telerik.com/blazor-ui/documentation/components/multiselect/events#valuechanged) fires on every keystroke, instead of when an item is selected. This happens because the MultiSelect component behaves like a text input.

> caption Allow custom user input in the MultiSelect component

<demo metaUrl="client/multiselect/custom-value/example-1/" height="420"></demo>

## Limitations

* `AllowCustom` is not compatible with [adaptive rendering](https://www.telerik.com/blazor-ui/documentation/common-features/adaptive-rendering).

## See Also

* [MultiSelect Overview](https://www.telerik.com/blazor-ui/documentation/components/multiselect/overview)
