Button

A clickable button, Slack's most common interactive element.

button is a clickable control that dispatches a block_actions payload when clicked. It can also carry a url to open a link, or a confirm object to ask before it fires.

Fields

Examples

Default, primary and danger styles

Link button

A url button still fires a block_actions payload; the browser navigation is a side effect the component performs in addition to dispatching.

As a section accessory

A button can sit to the right of a section’s text instead of inside an actions block.

With a confirmation dialog

Add confirm to make a destructive action ask first. See Confirmation dialogs for the full object shape.

Interactivity

Clicking a button (after any confirm dialog is accepted) calls onAction with a button action and, if url is set, opens it in a new tab:

{
  "type": "button",
  "action_id": "approve",
  "block_id": "approval",
  "action_ts": "1706000000.000100",
  "text": { "type": "plain_text", "text": "Approve", "emoji": true },
  "value": "approve_123",
  "style": "primary"
}

url and style are only included when the element itself sets them. A button doesn’t write to state.values: Slack only tracks state for elements that hold a value across interactions (selects, inputs, date pickers, and so on).

Related