Overflow menu element
A kebab (⋮) menu that opens a short list of actions or links.
overflow renders as a “⋮” button that opens a dropdown of up to 5 options. Reach for it when an
actions row or section accessory has more actions than fit as buttons.
Fields
typestring
Always overflow.
stringoptionsPlainTextOption[]
The menu's items, in order. Slack allows up to 5.
PlainTextOption[]action_id?string
Identifies this action in the interaction payload. Must be unique within the block. Maximum length is 255 characters.
stringconfirm?ConfirmationDialog
Shows a confirmation dialog before the selection is dispatched. See Confirmation dialogs.
ConfirmationDialogEach option is a plain-text option object:
textPlainTextElement
The option's label. Maximum length is 75 characters.
PlainTextElementvalue?string
Sent back in the interaction payload when this option is picked. Maximum length is 150 characters.
stringurl?string
Only valid on overflow options. Opens in a new tab when the option is clicked, in addition to dispatching the action. Maximum length is 3000 characters.
stringExamples
In an actions block
With a confirmation dialog
Interactivity
Picking an item (after any confirm dialog is accepted) closes the menu, calls onAction with the
chosen option’s text and value under selected_option, and opens the option’s url in a new
tab if it has one and it’s safe to follow (URL safety).
As in Slack, the action doesn’t carry the url:
{
"type": "overflow",
"action_id": "overflow-action",
"block_id": "b1",
"action_ts": "1706000000.000100",
"selected_option": {
"text": { "type": "plain_text", "text": "Open docs", "emoji": true },
"value": "value-2"
}
}
The menu opens 250px wide, its left edge under the button’s, as Slack’s does; near the window’s
right edge it shifts left to stay inside the window, as every menu and calendar does. Opening it moves
focus into the menu: the first ArrowDown highlights the first item, the arrow keys and Home/End move
the highlight, and Enter picks it. Escape or picking an item closes the menu and returns focus to
the button; an outside click closes it without moving focus. Like a button, overflow doesn’t write
to state.values: it’s a one-shot action, not a persisted value.