Messages · Step
Read a layout message
The text, pictures and button labels of a Components V2 message, like another bot's.
layout.read
In a flow
“When a button is clicked, read a layout message.”
Read a layout message → If Text contains 'winner' → React 🎉.
What it does
The text, pictures and button labels of a Components V2 message, like another bot's. It's a step: it runs when the white wire reaches it, then the flow carries on from its Then pin. It gives 4 values later steps can use. Find it under Messages in the palette.
When to use it
Use it when the flow needs to the text, pictures and button labels of a Components V2 message, like another bot's.
When not to
If nothing should change in Discord, a value node or a check is lighter.
Typical wiring
Sockets: settings you can wire
- Message Message
-
The layout message to read: a link, an id, or wire one in. Empty is the one clicked.
What goes there: Type it in the side panel, or wire in a message. e.g. a link to the message
If it's empty: Optional. Left empty and unwired, the step runs without it.
Connects fromCountdown messageCreate pollCreate poll from a listExport form recordsFind messageForward messagePinned messagesPoll with resultsand 526 more
- Channel Channel
-
Where the message is, when you give only its id. Empty is here.
What goes there: Type it in the side panel, or wire in a channel. e.g. #general
If it's empty: Optional. Left empty and unwired, the step runs without it.
Connects fromArchive channelAsk a questionCopy channelCopy permissionsCreate categoryCreate channelCreate forum postCreate threadand 60 more
Values it gives
- Text Text
-
All its text, one block a line. e.g. Welcome! Read the rules.
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAccept applicationAdd a forum tagAdd a labelAdd a Notion pageAdd a row to a Google SheetAdd a staff noteAdd a stickerAdd a Trello cardand 577 more
- Pictures list:text
-
Its picture links. e.g. https://…/a.png
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toCreate pollPoll with resultsAdd onboarding questionAdd to listAdd up timesAutoMod: add or remove allowed wordsAutoMod: add or remove wordsAutoMod: block wordsand 90 more
- Buttons list:text
-
Its button labels. e.g. Claim
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toCreate pollPoll with resultsAdd onboarding questionAdd to listAdd up timesAutoMod: add or remove allowed wordsAutoMod: add or remove wordsAutoMod: block wordsand 90 more
- Is a layout Yes / no
-
On when it's a Components V2 message. e.g. on
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAdd a forum tagAdd onboarding questionAdd to a counterAlarms that are dueAndAutoMod: Discord's word listsBluesky latest postBoard as emojiand 573 more