Skip to main content
Modals are pop-up forms in Slack that appear when users click specially configured buttons. Use them for feedback, approvals with comments, data entry, and surveys.

​
Prerequisites

A modal has:
  1. Title — At the top (max 24 characters)
  2. Input blocks — Form fields (text, textarea, select, checkboxes, datepicker, etc.)
  3. Submit button — Custom label (default: “Submit”)
  4. Close button — Custom label (default: “Cancel”)

​
Input types

Input TypeDescriptionUse Case
plain_text_inputSingle-line textNames, IDs, short answers
textareaMulti-line textComments, descriptions
static_selectDropdown, single selectionOne option from a list
multi_static_selectDropdown, multiple selectionsCategories, tags
checkboxesMultiple checkboxesMultiple options (visible)
radio_buttonsSingle selection (visible)One option (visible)
datepickerDate selectorDeadlines, scheduling
timepickerTime selectorAppointment times

​
Create a modal

  1. Go to Modals in the sidebar
  2. Click Create Modal
  3. Set Name (internal), Title (shown to users), and optional Description
  4. Optionally set Submit Label and Close Label
  5. Add input blocks for each field (label, type, required/optional, validation)
  6. Save the modal

​
Open a modal from a button

  1. Open your template and select a button
  2. In button settings, click Add Action → Open Modal
  3. Select your modal definition
  4. Save the template
When the user clicks the button, the modal opens. Use Data binding to pre-fill fields from the message, and Modal submissions to handle form submit (webhooks, message updates).

​
Next steps

Modal data binding

Pre-fill modal fields from the message.

Modal submissions

Handle submit with webhooks and message updates.