Skip to main content

Option object

Defines a single item in a number of item selection elements.

An object that represents a single selectable item in a select menu, multi-select menu, checkbox group, radio button group, or overflow menu.

Fields

FieldTypeDescriptionRequired?
textObjectA text object that defines the text shown in the option on the menu. Overflow, select, and multi-select menus can only use plain_text objects, while radio buttons and checkboxes can use mrkdwn text objects. Maximum length for the text in this field is 75 characters.Required
valueStringA unique string value that will be passed to your app when this option is chosen. Maximum length for this field is 150 characters.Required
descriptionObjectA plain_text text object that defines a line of descriptive text shown below the text field beside a single selectable item in a select menu, multi-select menu, checkbox group, radio button group, or overflow menu. Checkbox group and radio button group items can also use mrkdwn formatting. Maximum length for the text within this field is 75 characters.Optional
urlStringA URL to load in the user's browser when the option is clicked. The url attribute is only available in overflow menus. Maximum length for this field is 3000 characters. If you're using url, you'll still receive an interaction payload and will need to send an acknowledgement response.Optional

Example

{
"text": {
"type": "plain_text",
"text": "Maru"
},
"value": "maru"
}