---
url: https://docs.juniper.bot/en/message-templates/components/string-select-menu.md
description: String Select Menu component used in Message Templates.
---

[action]: ../../../cmd/custom/actions/index

[actions]: ../../../cmd/custom/actions/index

[`component.id`]: ../../types/custom-commands/component

[`component.selectedOptions`]: ../../types/custom-commands/component

[`modal.values`]: ../../types/custom-commands/modal

[Modal Forms]: ../../../cmd/custom/actions/modal-form

# String Select Menu

String Select Menu is interactive component that lets your member pick the option from the predefined list.

This component has the following settings:

![string_menu_settings_en](string_menu_settings_en.png)

* **Identifier** — component identifier, enter something related to the component;
  ::: info
  Identifier must be unique across all message components.

  [Action] executed by selection menu will get this identifier as [`component.id`] variable as well as list of
  selected options values as [`component.selectedOptions`] variable.

  For [Modal Forms], the message template of [Action] being executed by this modal will get [`modal.values`] variable map,
  containing the identifier as key and the list of selected [options](#options) as its value.

  Thus, this way you can determine what options were selected.
  :::
* **Minimum amount of values** — the minimum amount of values user has to select;
* **Maximum amount of values** — the maximum amount of values user is able to select;
* **Placeholder text if nothing is selected** — a placeholder text if nothing is selected;
* **Selection Options** — options to select (up to 25);
* **Action** — [Action] that will be executed by menu option selection (not available for [Modal Forms]);
* **Disabled** — checking this will make menu inactive, unable to be pressed (not available for [Modal Forms]);
* **Required** — the value will be required to fill if checked (only available for [Modal Forms]).

## Selection Options { #options }

Selection Options have the following settings:

![string_menu_variants_en](string_menu_variants_en.png)

* **Label** — Label of the select option;
* **Value** — Value of the select option, enter something related to this option;
  ::: info
  Value must be unique across all options of this menu.

  This value will be passed to [`component.selectedOptions`] list variable or to [`modal.values`] for [Modal Forms].

  Thus, this way you can determine in [Action] what exact options were selected.
  :::
* **Description** — select option description;
* **Selected by default** — checking this will make this options to be selected by default;
* **Add Emoji** — Add an Emoji to the select option.

## Availability { #availability }

This component is available for all message template modes (text, embed, components) of custom command's [actions].

It is also available for [Modal Forms].