Section block
A text block that can pair with fields or a single accessory element, and the block you'll reach for most often.
A section is the most flexible block in Block Kit. It shows a block of text, or up to 10
short fields laid out in two columns, and can add one interactive or decorative element
alongside as an accessory.
Fields
typestring
Always "section".
stringtext?text object
The text to show, as a plain_text or mrkdwn text object. Required unless fields is set. 1–3000 characters.
text objectfields?text object[]
Text objects rendered as two side-by-side columns. Required if text is omitted. Slack allows up to 10 fields, each up to 2000 characters.
text object[]accessory?element
One element shown alongside the text: a button, select, checkboxes, radio buttons, date/time picker, overflow menu, or image.
elementexpand?boolean
Whether the text always renders in full in Slack's apps. Block Kit Builder shows section text in full either way, and so does this renderer, so it changes nothing here.
booleanfalseblock_id?string
A unique identifier for the block, up to 255 characters. Slack generates one if omitted.
stringExamples
Plain text
Markdown text
mrkdwn text supports bold, strikethrough, links, and emoji shortcodes.
Two-column fields
Fields render as two columns. Combine text and fields on the same section to pair a
summary line with structured details.
Accessories
Buttons, selects, and other elements sit to the right of the text. checkboxes and
radio_buttons are the exception: Slack stacks those full-width below the text instead.
Long text
Section text renders in full, up to Slack’s 3,000-character limit, with no “Show more” toggle.
Block Kit Builder draws it the same way, with or without expand.
Interactivity
Every accessory that can act reports through onAction with the block’s block_id, the
element’s action_id, and a payload shaped for that element type.
A users_select selection dispatches:
{
"type": "users_select",
"block_id": "…",
"action_id": "assignee-select",
"selected_user": "U0ADA",
"action_ts": "…"
}
Buttons include value (and url/style when set); other selects include
selected_option, selected_options, selected_date, or selected_conversation in place
of selected_user, matching the field Slack documents for that element.



