Nodes
Every step you can add to a flow, grouped by category, with its settings and ways out.
A node is one step in a flow. This section documents all of them. Each node has the same parts, and each page follows the same layout.
How to read a node
| Part | What it is |
|---|---|
| Kind | The identifier that appears in the blueprint, such as message.reply. |
| Settings | The fields you fill in. Text fields accept tokens unless noted. |
| Ways out | The handles on the right edge. A branching node has one for each outcome. |
| Summary | What the node says about itself on the canvas. |
Categories
Triggers
The seven nodes that start a flow.
Messages
Reply, send, read, edit, delete, react and more.
Members
Roles, nicknames, lookups, timeouts, kicks and bans.
Server
Channels, roles, permissions, threads, events, emoji and the bot's status.
Voice
Join, leave, play sounds, make channels, move, mute and deafen.
Conditions
Branch on values, permissions, roles, members, messages, chance and cooldowns.
Variables and data
Store values, do maths, handle text, lists, JSON and dates, and work with collections.
Integrations
Call APIs, watch feeds, run code and write logs.
Flow control
Wait, wait for replies, loop, try, call other flows and stop.
Ways out
Most nodes have one way out, labeled out. Branching nodes have named ways out. Green ways out mark the expected outcome and red ones mark the other.
Any node that can fail also offers a red If it fails way out. Turn it on in the node's settings. See Handling failures.
Shared settings
Several settings appear on many nodes and mean the same thing everywhere.
| Setting | What it does |
|---|---|
| Message | The text to send. Accepts tokens. |
| Embed | One of your embeds. |
| Buttons and menus | One of your component sets. |
| Only visible to the user | Makes the reply ephemeral: only the person who triggered the flow sees it. |
| Member | A member's ID, a mention, or a token such as {option.member} or {user.id}. Left empty on a moderation step, it's the member a command names, or else whoever started the flow. |
| Audit log reason | The reason Discord records in the server's audit log. |
| Channel | A channel of the server. |
| Role | A role of the server. |
| Where, Sorted by, Read the row as | The collection query settings. |
Unknown steps
If a step's type no longer exists, the canvas shows Unknown step. Delete it and add its replacement.