Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 20 additions & 1 deletion docs/english/concepts/creating-modals.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,4 +70,23 @@ app.command('/ticket', async ({ ack, body, client, logger }) => {
logger.error(error);
}
});
```
```

### Making input blocks optional

Set `optional: true` on the enclosing `input` block when users should be able to submit the view without providing a value. This setting applies to the element inside the block, including select menus such as `multi_external_select`; the element itself does not need an `optional` field.

Comment on lines +77 to +78

@srtaalej srtaalej Aug 10, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Set `optional: true` on the enclosing `input` block when users should be able to submit the view without providing a value. This setting applies to the element inside the block, including select menus such as `multi_external_select`; the element itself does not need an `optional` field.
Set `optional: true` on the enclosing `input` block when users should be able to submit the view without providing a value. This setting applies to elements inside the block, including select menus such as `multi_external_select`; the element itself does not need an `optional` field.

Thank you for taking the time to open this PR @deepunyk! This looks pretty good to me. I've requested review from our docs team 🫡
I have one suggestion to make this a bit easier to read 😅 Also would really appreciate a changeset!

```javascript
{
type: 'input',
optional: true,
label: {
type: 'plain_text',
text: 'Choose projects'
},
element: {
type: 'multi_external_select',
action_id: 'projects'
}
}
```