BotFrame

Server actions · Workflow node

Add role

The Add role node as it appears in the workflow editor.

What it does

Grant a role to the current member.

When the workflow reaches this node, BotFrame uses the current server details and any connected IDs to perform the Discord action. After the action completes, the workflow continues through Flow.

Typical use

Give a verified member the Member role.

How to use it

  1. Add it from Server actionsOpen the node library and choose Add role from Server actions.
  2. Connect the workflow pathConnect Flow in from the previous step and Flow to the next step.
  3. Choose settings and connect valuesSet Member, Role. Connections can also supply values produced by earlier nodes.

Settings

These are the options shown when you add this node. A connected value can replace a setting when the workflow runs.

SettingStarting valueWhat it controls
Memberevent_userChooses which member receives the role.
RoleEmptyUsed when Role ID is not connected from an earlier node.

Value connections

Value connections pass information between nodes without changing the order of the workflow. When an input is not connected, BotFrame uses the value selected in the node or details from the starting Discord event when available.

Inputs

User IDUser · Defaults to the member who started the workflow
Optional
Role IDRole
Required

Outputs

This item has no separate value output. Its Flow connection continues the workflow.

What happens when it runs

When the workflow reaches this node, BotFrame uses the current server details and any connected IDs to perform the Discord action. After the action completes, the workflow continues through Flow.

You can use this item in a published BotFrame workflow. You can also test it in the simulator.

These details match the node currently available in the BotFrame workflow editor.