Message components

Build the parts of a message, such as sections, galleries, containers, buttons, charts and attachments.

Create attachment from text

Creates a file attachment from text content (e.g. transcripts, exports or logs).

Inputs

Name	Type	Required	Details
File name	Text	Yes	Name of the file including its extension (e.g. "transcript.txt"). Maximum length: 100 characters.
Content	Text	Yes	Text content of the file. Maximum length: 100000 characters.

Outputs

Name	Type	Details
Attachment	Attachment	The created attachment.

Create media item

Builds a media item that can be reused inside thumbnails, file components, or media galleries.

Inputs

Name	Type	Required	Details
URL	URL	Yes	Source URL or attachment://filename reference.
Description	Text	No	Optional alt text (max 1024). Maximum length: 1024 characters.

Outputs

Name	Type	Details
Media	Media item	The new media item.

Create text display

Builds a Components V2 text-display block from markdown content.

Inputs

Name	Type	Required	Details
Content	Text	Yes	Markdown text up to 4000 characters. Maximum length: 4000 characters.

Outputs

Name	Type	Details
Text Display	Text display component	The new text-display component.

Create thumbnail

Builds a thumbnail component to use as the accessory of a section.

Inputs

Name	Type	Required	Details
URL	URL	Yes	URL or attachment reference for the thumbnail.
Description	Text	No	Optional alt text (max 1024). Maximum length: 1024 characters.
Spoiler	Yes/No	Yes	Whether the thumbnail is hidden behind a spoiler. Default: No.

Outputs

Name	Type	Details
Thumbnail	Thumbnail component	The new thumbnail component.

Create media gallery item

Builds a single item to add into a media gallery.

Inputs

Name	Type	Required	Details
URL	URL	Yes	URL or attachment reference for the item.
Description	Text	No	Optional alt text (max 1024). Maximum length: 1024 characters.
Spoiler	Yes/No	Yes	Whether the item is hidden behind a spoiler. Default: No.

Outputs

Name	Type	Details
Item	Media gallery item	The new media gallery item.

Create media gallery

Builds a media-gallery component containing 1-10 media items.

Inputs

Name	Type	Required	Details
Items	List of Media gallery item	Yes	The gallery's items (1-10). Items: 1 to 10.

Outputs

Name	Type	Details
Gallery	Media gallery component	The new media gallery.

Add item to media gallery

Appends an item to an existing media gallery and returns the updated gallery.

Inputs

Name	Type	Required	Details
Gallery	Media gallery component	Yes	The gallery to extend.
Item	Media gallery item	Yes	The item to append.

Outputs

Name	Type	Details
Gallery	Media gallery component	The updated gallery.

Render progress bar

Renders a text progress bar for a value out of a maximum. Great for XP, health, poll shares or task completion.

Inputs

Name	Type	Required	Details
Value	Decimal number	Yes	The current value (clamped to the 0-maximum range).
Maximum	Decimal number	Yes	The value that represents a full bar. Must be greater than zero.
Width	Whole number	No	How many characters wide the bar is (default 20). Value: 1 to 100. Default: 20.
Filled Character	Text	No	Character used for the filled portion (default █). Length: 1 to 8 characters.
Empty Character	Text	No	Character used for the empty portion (default ░). Length: 1 to 8 characters.
Show Percentage	Yes/No	No	Append the rounded percentage after the bar. Default: No.

Outputs

Name	Type	Details
Text	Text	The rendered progress bar.

Render bar chart

Renders a horizontal ASCII bar chart from labels and values, scaled to the largest value. Wrap it in a code block for aligned columns.

Inputs

Name	Type	Required	Details
Labels	List of Text	Yes	One label per bar. Must be the same length as the values. Maximum items: 25.
Values	List of Decimal number	Yes	One value per bar. Must be the same length as the labels. Maximum items: 25.
Width	Whole number	No	How many characters wide the longest bar is (default 20). Value: 1 to 100. Default: 20.

Outputs

Name	Type	Details
Text	Text	The rendered bar chart (one row per label).

Render sparkline

Renders a compact single-line trend graph from a series of numbers using the ▁▂▃▄▅▆▇█ ramp.

Inputs

Name	Type	Required	Details
Values	List of Decimal number	Yes	The series of numbers to plot as a sparkline. Maximum items: 400.

Outputs

Name	Type	Details
Text	Text	The rendered sparkline.

Create message pages

Creates an empty page list that you fill with add-message-page, then hand to a paginated sender.

Outputs

Name	Type	Details
Pages	List of Message content	The newly created empty page list.

Add message page

Appends a message to a page list and returns the updated list. Build the list in a loop, one page at a time.

Inputs

Name	Type	Required	Details
Pages	List of Message content	Yes	The page list to extend. Maximum items: 100.
Page	Message content	Yes	The message content to append as a new page.

Outputs

Name	Type	Details
Pages	List of Message content	The updated page list.

Create separator

Builds a separator component used to add space between V2 components.

Inputs

Name	Type	Required	Details
Divider	Yes/No	Yes	Whether to render the divider line. Default: Yes.
Spacing	Separator spacing	Yes	Vertical spacing size. Default: Small.

Outputs

Name	Type	Details
Separator	Separator component	The new separator.

Create file component

Builds a Components V2 file component referencing an attachment.

Inputs

Name	Type	Required	Details
File	Media item	Yes	Media item pointing to the attachment.
Spoiler	Yes/No	Yes	Whether the file is hidden behind a spoiler. Default: No.

Outputs

Name	Type	Details
File Component	File component	The new file component.

Create section

Builds a section made of 1-3 text displays plus a thumbnail OR button accessory.

Inputs

Name	Type	Required	Details
Text Displays	List of Text display component	Yes	1-3 text-display children. Items: 1 to 3.
Accessory (Thumbnail)	Thumbnail component	No	Thumbnail accessory. Provide this OR a button. Use only one of these: Accessory (Button)
Accessory (Button)	Button	No	Button accessory. Provide this OR a thumbnail. Use only one of these: Accessory (Thumbnail)

Outputs

Name	Type	Details
Section	Section component	The new section component.

Create empty container

Creates an empty container that you can populate with the add-*-to-container actions.

Outputs

Name	Type	Details
Container	Container component	The newly created empty container.

Set container accent color

Updates the accent color displayed on the left edge of a container.

Inputs

Name	Type	Required	Details
Container	Container component	Yes	The container to modify.
Accent Color	Color	Yes	New accent color, or empty to remove it.

Outputs

Name	Type	Details
Container	Container component	The updated container.

Set container spoiler

Toggles whether the entire container is hidden behind a spoiler.

Inputs

Name	Type	Required	Details
Container	Container component	Yes	The container to modify.
Spoiler	Yes/No	Yes	Whether the container is a spoiler.

Outputs

Name	Type	Details
Container	Container component	The updated container.

Add text display to container

Appends a text-display child to a container.

Inputs

Name	Type	Required	Details
Container	Container component	Yes	The container to modify.
Text Display	Text display component	Yes	The text-display to append.

Outputs

Name	Type	Details
Container	Container component	The updated container.

Add section to container

Appends a section child to a container.

Inputs

Name	Type	Required	Details
Container	Container component	Yes	The container to modify.
Section	Section component	Yes	The section to append.

Outputs

Name	Type	Details
Container	Container component	The updated container.

Add media gallery to container

Appends a media-gallery child to a container.

Inputs

Name	Type	Required	Details
Container	Container component	Yes	The container to modify.
Gallery	Media gallery component	Yes	The gallery to append.

Outputs

Name	Type	Details
Container	Container component	The updated container.

Add separator to container

Appends a separator child to a container.

Inputs

Name	Type	Required	Details
Container	Container component	Yes	The container to modify.
Separator	Separator component	Yes	The separator to append.

Outputs

Name	Type	Details
Container	Container component	The updated container.

Add file to container

Appends a file child to a container.

Inputs

Name	Type	Required	Details
Container	Container component	Yes	The container to modify.
File Component	File component	Yes	The file component to append.

Outputs

Name	Type	Details
Container	Container component	The updated container.

Add action row to container

Appends an action-row child to a container.

Inputs

Name	Type	Required	Details
Container	Container component	Yes	The container to modify.
Action Row	Action row component	Yes	The action row to append.

Outputs

Name	Type	Details
Container	Container component	The updated container.

Create action row (buttons)

Builds an action row containing up to 5 buttons.

Inputs

Name	Type	Required	Details
Buttons	List of Button	Yes	1-5 buttons to place in the row. Items: 1 to 5.

Outputs

Name	Type	Details
Action Row	Action row component	The new action row.

Add button to action row

Appends a button to an action row and returns the updated row (max 5 buttons).

Inputs

Name	Type	Required	Details
Action Row	Action row component	Yes	The action row to extend.
Button	Button	Yes	The button to append.

Outputs

Name	Type	Details
Action Row	Action row component	The updated action row.