Dropdowns

Create dropdowns and change their settings before you add them to a message.

Create action row with dropdown

Builds an action row containing exactly one dropdown of any kind.

Inputs

Name	Type	Required	Details
Dropdown	Dropdown	No	Provide one of the dropdown inputs. Use only one of these: User dropdown, Role dropdown, Channel dropdown, User-or-role dropdown.
User dropdown	User dropdown	No	Provide one of the dropdown inputs. Use only one of these: Dropdown, Role dropdown, Channel dropdown, User-or-role dropdown.
Role dropdown	Role dropdown	No	Provide one of the dropdown inputs. Use only one of these: Dropdown, User dropdown, Channel dropdown, User-or-role dropdown.
Channel dropdown	Channel dropdown	No	Provide one of the dropdown inputs. Use only one of these: Dropdown, User dropdown, Role dropdown, User-or-role dropdown.
User-or-role dropdown	User-or-role dropdown	No	Provide one of the dropdown inputs. Use only one of these: Dropdown, User dropdown, Role dropdown, Channel dropdown.

Outputs

Name	Type	Details
Action Row	Action row component	The new action row.

Create dropdown

Builds a dropdown (a text-choice dropdown) ready to be embedded in an action row. Add its choices with "Add option to dropdown".

Inputs

Name	Type	Required	Details
Custom ID	Text	No	Custom id used to route the submission (also matched by dropdown-submitted triggers). Length: 1 to 100 characters.
Target Flow	Flow	No	Flow to invoke when a selection is made.
Placeholder	Text	No	Placeholder text shown when nothing is selected (max 150). Maximum length: 150 characters.
Min Values	Whole number	Yes	Minimum number of selectable options (0-25). Value: 0 to 25. Default: 1.
Max Values	Whole number	Yes	Maximum number of selectable options (1-25). Value: 1 to 25. Default: 1.
Disabled	Yes/No	Yes	Whether the menu is rendered as disabled. Default: No.

Outputs

Name	Type	Details
Menu	Dropdown	The newly created menu.

Set dropdown placeholder

Updates the placeholder text on a dropdown.

Inputs

Name	Type	Required	Details
Menu	Dropdown	Yes	The menu to modify.
Placeholder	Text	Yes	New placeholder, or empty to clear. Maximum length: 150 characters.

Outputs

Name	Type	Details
Menu	Dropdown	The updated menu.

Set dropdown minimum choices

Updates the minimum number of choices a user must pick in a dropdown.

Inputs

Name	Type	Required	Details
Menu	Dropdown	Yes	The menu to modify.
Min Values	Whole number	Yes	Minimum number of selectable options (0-25). Value: 0 to 25.

Outputs

Name	Type	Details
Menu	Dropdown	The updated menu.

Set dropdown maximum choices

Updates the maximum number of choices a user can pick in a dropdown.

Inputs

Name	Type	Required	Details
Menu	Dropdown	Yes	The menu to modify.
Max Values	Whole number	Yes	Maximum number of selectable options (1-25). Value: 1 to 25.

Outputs

Name	Type	Details
Menu	Dropdown	The updated menu.

Set dropdown disabled

Enables or disables a dropdown.

Inputs

Name	Type	Required	Details
Menu	Dropdown	Yes	The menu to modify.
Disabled	Yes/No	Yes	Whether the menu is rendered as disabled.

Outputs

Name	Type	Details
Menu	Dropdown	The updated menu.

Set dropdown target flow

Sets or clears the flow invoked when a selection is made.

Inputs

Name	Type	Required	Details
Menu	Dropdown	Yes	The menu to modify.
Target Flow	Flow	Yes	Flow to invoke when a selection is made, or empty to clear.

Outputs

Name	Type	Details
Menu	Dropdown	The updated menu.

Add option to dropdown

Appends a choice to a dropdown and returns the updated dropdown (max 25 options).

Inputs

Name	Type	Required	Details
Menu	Dropdown	Yes	The dropdown to extend.
Label	Text	Yes	Option label shown to the user (1-100). Length: 1 to 100 characters.
Value	Text	Yes	Value reported back when this option is chosen (1-100). Length: 1 to 100 characters.
Description	Text	No	Optional secondary text shown under the label. Maximum length: 100 characters.
Emoji	Text	No	Optional emoji shown next to the option.
Default	Yes/No	No	Whether this option is selected by default. Default: No.
Flow to run	Flow	No	The flow that runs when someone picks this option. Leave blank to use the menu's own flow.

Outputs

Name	Type	Details
Menu	Dropdown	The updated menu.

Set dropdown selected values

Returns a copy of a dropdown with the given values marked as selected (their option's default set to true) and every other option explicitly deselected.

Inputs

Name	Type	Required	Details
Menu	Dropdown	Yes	The dropdown to update.
Values	List of Text	Yes	The option values that should appear pre-selected. Maximum items: 25.

Outputs

Name	Type	Details
Menu	Dropdown	The updated menu with its options' default flags set.

Create user dropdown

Builds a user dropdown ready to be embedded in an action row.

Inputs

Name	Type	Required	Details
Target Flow	Flow	No	Flow to invoke when a selection is made.
Placeholder	Text	No	Placeholder text shown when nothing is selected (max 150). Maximum length: 150 characters.
Min Values	Whole number	Yes	Minimum number of selectable items (0-25). Value: 0 to 25. Default: 1.
Max Values	Whole number	Yes	Maximum number of selectable items (1-25). Value: 1 to 25. Default: 1.
Disabled	Yes/No	Yes	Whether the menu is rendered as disabled. Default: No.
Default Users	List of User	No	Pre-selected users. Maximum items: 25.

Outputs

Name	Type	Details
Menu	User dropdown	The newly created menu.

Set user dropdown placeholder

Updates the placeholder text on a user dropdown.

Inputs

Name	Type	Required	Details
Menu	User dropdown	Yes	The menu to modify.
Placeholder	Text	Yes	New placeholder, or empty to clear. Maximum length: 150 characters.

Outputs

Name	Type	Details
Menu	User dropdown	The updated menu.

Set user dropdown minimum choices

Updates the minimum number of selectable items on a user dropdown.

Inputs

Name	Type	Required	Details
Menu	User dropdown	Yes	The menu to modify.
Min Values	Whole number	Yes	New minimum (0-25). Value: 0 to 25.

Outputs

Name	Type	Details
Menu	User dropdown	The updated menu.

Set user dropdown maximum choices

Updates the maximum number of selectable items on a user dropdown.

Inputs

Name	Type	Required	Details
Menu	User dropdown	Yes	The menu to modify.
Max Values	Whole number	Yes	New maximum (1-25). Value: 1 to 25.

Outputs

Name	Type	Details
Menu	User dropdown	The updated menu.

Set user dropdown disabled

Toggles the disabled state of a user dropdown.

Inputs

Name	Type	Required	Details
Menu	User dropdown	Yes	The menu to modify.
Disabled	Yes/No	Yes	Whether the menu is disabled.

Outputs

Name	Type	Details
Menu	User dropdown	The updated menu.

Set user dropdown target flow

Updates which flow runs when a user dropdown is interacted with.

Inputs

Name	Type	Required	Details
Menu	User dropdown	Yes	The menu to modify.
Target Flow	Flow	Yes	Flow to invoke, or empty to clear.

Outputs

Name	Type	Details
Menu	User dropdown	The updated menu.

Set user dropdown preselection

Updates the pre-selected items on a user dropdown.

Inputs

Name	Type	Required	Details
Menu	User dropdown	Yes	The menu to modify.
Default Users	List of User	Yes	New default users (max 25). Maximum items: 25.

Outputs

Name	Type	Details
Menu	User dropdown	The updated menu.

Create role dropdown

Builds a role dropdown ready to be embedded in an action row.

Inputs

Name	Type	Required	Details
Target Flow	Flow	No	Flow to invoke when a selection is made.
Placeholder	Text	No	Placeholder text shown when nothing is selected (max 150). Maximum length: 150 characters.
Min Values	Whole number	Yes	Minimum number of selectable items (0-25). Value: 0 to 25. Default: 1.
Max Values	Whole number	Yes	Maximum number of selectable items (1-25). Value: 1 to 25. Default: 1.
Disabled	Yes/No	Yes	Whether the menu is rendered as disabled. Default: No.
Default Roles	List of Role	No	Pre-selected roles. Maximum items: 25.

Outputs

Name	Type	Details
Menu	Role dropdown	The newly created menu.

Set role dropdown placeholder

Updates the placeholder text on a role dropdown.

Inputs

Name	Type	Required	Details
Menu	Role dropdown	Yes	The menu to modify.
Placeholder	Text	Yes	New placeholder, or empty to clear. Maximum length: 150 characters.

Outputs

Name	Type	Details
Menu	Role dropdown	The updated menu.

Set role dropdown minimum choices

Updates the minimum number of selectable items on a role dropdown.

Inputs

Name	Type	Required	Details
Menu	Role dropdown	Yes	The menu to modify.
Min Values	Whole number	Yes	New minimum (0-25). Value: 0 to 25.

Outputs

Name	Type	Details
Menu	Role dropdown	The updated menu.

Set role dropdown maximum choices

Updates the maximum number of selectable items on a role dropdown.

Inputs

Name	Type	Required	Details
Menu	Role dropdown	Yes	The menu to modify.
Max Values	Whole number	Yes	New maximum (1-25). Value: 1 to 25.

Outputs

Name	Type	Details
Menu	Role dropdown	The updated menu.

Set role dropdown disabled

Toggles the disabled state of a role dropdown.

Inputs

Name	Type	Required	Details
Menu	Role dropdown	Yes	The menu to modify.
Disabled	Yes/No	Yes	Whether the menu is disabled.

Outputs

Name	Type	Details
Menu	Role dropdown	The updated menu.

Set role dropdown target flow

Updates which flow runs when a role dropdown is interacted with.

Inputs

Name	Type	Required	Details
Menu	Role dropdown	Yes	The menu to modify.
Target Flow	Flow	Yes	Flow to invoke, or empty to clear.

Outputs

Name	Type	Details
Menu	Role dropdown	The updated menu.

Set role dropdown preselection

Updates the pre-selected items on a role dropdown.

Inputs

Name	Type	Required	Details
Menu	Role dropdown	Yes	The menu to modify.
Default Roles	List of Role	Yes	New default roles (max 25). Maximum items: 25.

Outputs

Name	Type	Details
Menu	Role dropdown	The updated menu.

Create channel dropdown

Builds a channel dropdown ready to be embedded in an action row.

Inputs

Name	Type	Required	Details
Target Flow	Flow	No	Flow to invoke when a selection is made.
Placeholder	Text	No	Placeholder text shown when nothing is selected (max 150). Maximum length: 150 characters.
Min Values	Whole number	Yes	Minimum number of selectable items (0-25). Value: 0 to 25. Default: 1.
Max Values	Whole number	Yes	Maximum number of selectable items (1-25). Value: 1 to 25. Default: 1.
Disabled	Yes/No	Yes	Whether the menu is rendered as disabled. Default: No.
Default Channels	List of Server channel	No	Pre-selected channels. Maximum items: 25.
Channel Types	List of Channel type	No	Restrict selectable channels to these types.

Outputs

Name	Type	Details
Menu	Channel dropdown	The newly created menu.

Set channel dropdown placeholder

Updates the placeholder text on a channel dropdown.

Inputs

Name	Type	Required	Details
Menu	Channel dropdown	Yes	The menu to modify.
Placeholder	Text	Yes	New placeholder, or empty to clear. Maximum length: 150 characters.

Outputs

Name	Type	Details
Menu	Channel dropdown	The updated menu.

Set channel dropdown minimum choices

Updates the minimum number of selectable items on a channel dropdown.

Inputs

Name	Type	Required	Details
Menu	Channel dropdown	Yes	The menu to modify.
Min Values	Whole number	Yes	New minimum (0-25). Value: 0 to 25.

Outputs

Name	Type	Details
Menu	Channel dropdown	The updated menu.

Set channel dropdown maximum choices

Updates the maximum number of selectable items on a channel dropdown.

Inputs

Name	Type	Required	Details
Menu	Channel dropdown	Yes	The menu to modify.
Max Values	Whole number	Yes	New maximum (1-25). Value: 1 to 25.

Outputs

Name	Type	Details
Menu	Channel dropdown	The updated menu.

Set channel dropdown disabled

Toggles the disabled state of a channel dropdown.

Inputs

Name	Type	Required	Details
Menu	Channel dropdown	Yes	The menu to modify.
Disabled	Yes/No	Yes	Whether the menu is disabled.

Outputs

Name	Type	Details
Menu	Channel dropdown	The updated menu.

Set channel dropdown target flow

Updates which flow runs when a channel dropdown is interacted with.

Inputs

Name	Type	Required	Details
Menu	Channel dropdown	Yes	The menu to modify.
Target Flow	Flow	Yes	Flow to invoke, or empty to clear.

Outputs

Name	Type	Details
Menu	Channel dropdown	The updated menu.

Set channel dropdown preselection

Updates the pre-selected items on a channel dropdown.

Inputs

Name	Type	Required	Details
Menu	Channel dropdown	Yes	The menu to modify.
Default Channels	List of Server channel	Yes	New default channels (max 25). Maximum items: 25.

Outputs

Name	Type	Details
Menu	Channel dropdown	The updated menu.

Create user-or-role dropdown

Builds a user-or-role dropdown ready to be embedded in an action row.

Inputs

Name	Type	Required	Details
Target Flow	Flow	No	Flow to invoke when a selection is made.
Placeholder	Text	No	Placeholder text shown when nothing is selected (max 150). Maximum length: 150 characters.
Min Values	Whole number	Yes	Minimum number of selectable items (0-25). Value: 0 to 25. Default: 1.
Max Values	Whole number	Yes	Maximum number of selectable items (1-25). Value: 1 to 25. Default: 1.
Disabled	Yes/No	Yes	Whether the menu is rendered as disabled. Default: No.
Default Users	List of User	No	Pre-selected users (max 25). Maximum items: 25.
Default Roles	List of Role	No	Pre-selected roles (max 25). Maximum items: 25.

Outputs

Name	Type	Details
Menu	User-or-role dropdown	The newly created menu.

Set user-or-role dropdown placeholder

Updates the placeholder text on a user-or-role dropdown.

Inputs

Name	Type	Required	Details
Menu	User-or-role dropdown	Yes	The menu to modify.
Placeholder	Text	Yes	New placeholder, or empty to clear. Maximum length: 150 characters.

Outputs

Name	Type	Details
Menu	User-or-role dropdown	The updated menu.

Set user-or-role dropdown minimum choices

Updates the minimum number of selectable items on a user-or-role dropdown.

Inputs

Name	Type	Required	Details
Menu	User-or-role dropdown	Yes	The menu to modify.
Min Values	Whole number	Yes	New minimum (0-25). Value: 0 to 25.

Outputs

Name	Type	Details
Menu	User-or-role dropdown	The updated menu.

Set user-or-role dropdown maximum choices

Updates the maximum number of selectable items on a user-or-role dropdown.

Inputs

Name	Type	Required	Details
Menu	User-or-role dropdown	Yes	The menu to modify.
Max Values	Whole number	Yes	New maximum (1-25). Value: 1 to 25.

Outputs

Name	Type	Details
Menu	User-or-role dropdown	The updated menu.

Set user-or-role dropdown disabled

Toggles the disabled state of a user-or-role dropdown.

Inputs

Name	Type	Required	Details
Menu	User-or-role dropdown	Yes	The menu to modify.
Disabled	Yes/No	Yes	Whether the menu is disabled.

Outputs

Name	Type	Details
Menu	User-or-role dropdown	The updated menu.

Set user-or-role dropdown target flow

Updates which flow runs when a user-or-role dropdown is interacted with.

Inputs

Name	Type	Required	Details
Menu	User-or-role dropdown	Yes	The menu to modify.
Target Flow	Flow	Yes	Flow to invoke, or empty to clear.

Outputs

Name	Type	Details
Menu	User-or-role dropdown	The updated menu.

Set user-or-role dropdown preselected users

Updates the pre-selected users on a user-or-role dropdown.

Inputs

Name	Type	Required	Details
Menu	User-or-role dropdown	Yes	The menu to modify.
Default Users	List of User	Yes	New default users (max 25). Maximum items: 25.

Outputs

Name	Type	Details
Menu	User-or-role dropdown	The updated menu.

Set user-or-role dropdown preselected roles

Updates the pre-selected roles on a user-or-role dropdown.

Inputs

Name	Type	Required	Details
Menu	User-or-role dropdown	Yes	The menu to modify.
Default Roles	List of Role	Yes	New default roles (max 25). Maximum items: 25.

Outputs

Name	Type	Details
Menu	User-or-role dropdown	The updated menu.

Set channel dropdown channel types

Restricts which channel types can be picked in a channel dropdown.

Inputs

Name	Type	Required	Details
Menu	Channel dropdown	Yes	The channel dropdown to modify.
Channel Types	List of Channel type	Yes	Allowed channel types.

Outputs

Name	Type	Details
Menu	Channel dropdown	The updated menu.