> For the complete documentation index, see [llms.txt](https://2600hz.gitbook.io/sds/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://2600hz.gitbook.io/sds/sds-3.0/sds-components/components/multiselect.md).

# MultiSelect

A MultiSelect component typically consists of a clickable area that, when activated, reveals a list of options. Users can select multiple options from the list by clicking or tapping on each option.

### Use cases

✅ Multiple selections: Use MultiSelect components when users need to choose multiple options from a list. This is particularly useful when users need to apply filters, select items for an action, or categorize content.

✅ Efficient selection: Provide users with a streamlined way to make multiple selections without the need for individual interactions for each option.

✅ Clear representation: MultiSelect components visually represent the chosen options, making it easy for users to see their selections at a glance.

✅ Data filtering: Utilize MultiSelect components to allow users to filter data or content based on multiple criteria simultaneously.

✅ Flexible input: MultiSelect components are particularly useful when users may need to make selections from a large list of options.

### **Not to Use Cases:**

❌ Single selections: Avoid using MultiSelect components when users are expected to make only one choice. In such cases, a regular select or radio buttons may be more appropriate.

❌ Overwhelming options: Do not overload MultiSelect components with an excessive number of options. A long list of options can make it difficult for users to find and select their desired choices.

❌ Confusing interactions: Avoid implementing complex interactions, such as nested MultiSelects, that can confuse users and make the selection process more challenging.
