Skip to main content
Slack messages are built from blocks — modular components you combine to build exactly what you need. This guide covers available block types, when to use them, and how to configure them.

​
Prerequisites

​
Block types overview

​
Header block

Use for the main message title. Keep text short (under 150 characters). Plain text:
With placeholders:
Put the header at the top of your message. Use sentence case or title case.

​
Section block

The main content block. Sections contain text and can include an optional accessory (image, button, or select menu) on the right. Basic text:
With placeholders:
With fields (two columns): Left: Status: {{order.status}} · Right: Total: ${{order.total}}

​
Context block

Small, muted text for metadata like timestamps or authors. Place at the bottom of sections. Example elements:
  • Created by {{author.name}} · • · {{created_at}}
Renders as: Created by Sarah Chen • January 15, 2025

​
Actions block

Contains interactive buttons. Each button needs:
  • Label: Text on the button (e.g. “Approve”, “View Details”)
  • Action ID: Unique identifier (e.g. approve_request)
  • Style: Primary (green), Danger (red), or Default (gray)
  • Value: Optional data when clicked (e.g. {{request.id}})
Limit to 5 buttons per Actions block. See Interactive buttons for connecting buttons to webhooks and modals.

​
Divider block

A horizontal line between sections. Use sparingly (1–2 per message).

​
Rich Text block

Formatted text with lists, quotes, code blocks, and inline styling. Formatting: *bold* · _italic_ · `code` · <url|text> for links

​
Table block

Display tabular data. Configure data path (e.g. products) and columns with placeholders like {{this.name}}, {{this.quantity}}. See Table blocks for structure, columns, and advanced options (experimental feature).

​
Combining blocks

Typical layout:
  1. Header — message title
  2. Section — primary content
  3. Divider — visual break
  4. Section — additional details
  5. Context — metadata
  6. Actions — buttons

​
Next steps

Placeholders

Dynamic data syntax for blocks.

Table blocks

Structured tabular data (experimental).

Directives

Generate repeating blocks with #each.

Interactive buttons

Configure buttons and actions.