Skip to main content

Views

View factories for Slack modals and App Home tabs.

homeTab()

homeTab(input, settings?): SlackObject<"home">

Creates an App Home tab view payload.

Input fields

Home-tab blocks and optional application metadata.

Input fieldTypeDescription
blocksJsonObject[]Between one and 100 App Home-compatible blocks.
callbackId?stringApplication-defined callback identifier.
externalId?stringApplication-defined external identifier.
privateMetadata?stringOpaque application metadata returned with view interactions.

Settings

SettingTypeDescription
settingsFactorySettingsPer-call validation settings.

Returns

SlackObject<"home">

A validated Slack home view.

Throws

InvalidUsageError when blocks or metadata violate Slack's constraints.


modal(input, settings?): SlackObject<"modal">

Creates a modal view payload.

Input fields

Modal title, blocks, controls, metadata, and callback behavior.

Input fieldTypeDescription
blocksJsonObject[]Between one and 100 modal-compatible blocks.
callbackId?stringApplication-defined callback identifier.
clearOnClose?booleanClose every view above this modal when it closes.
close?TextLikeOptional plain-text close-button label.
externalId?stringApplication-defined external identifier.
notifyOnClose?booleanSend a view_closed event when the modal closes.
privateMetadata?stringOpaque application metadata returned with view interactions.
submit?TextLikeOptional plain-text submit-button label.
submitDisabled?booleanKeep the submit button disabled until an input changes.
titleTextLikePlain-text modal title, up to 24 characters.

Settings

SettingTypeDescription
settingsFactorySettingsPer-call validation settings.

Returns

SlackObject<"modal">

A validated Slack modal view.

Throws

InvalidUsageError when blocks or text fields violate Slack's constraints.