Flow reference: Moderation

Ban User

Ban the selected Discord user.

Ban the selected Discord user.

When and how to use it

Connect the input from the preceding step on the path that should perform this operation.
Fill the fields with data available in the trigger's context.
Connect the needed outputs; an unconnected path cannot run later blocks.

Configuration fields

User — user


Choose the target user. {user} may be a command's selected user; {author} is the caller. Use an ID or the variable picker rather than a display name.

Input: Text with variable suggestions.

Format example, not a ready value for your server: {user}.

Default: {user}.


Reason — reason


Describe why the action is taken. Use a meaningful audit/support explanation and avoid sensitive personal details.

Input: Text with variable suggestions.

Format example, not a ready value for your server: {reason}.

Default: {reason}.


Delete message history — deleteHistory


Choose how much recent message history to remove with the ban. This can delete real member content.

Input: Fixed choice.

Default: 1d.

Available choices (preserve the exact value):
none — Don't delete any
1h — Previous hour
1d — Previous 24 hours
7d — Previous 7 days

Outputs and next steps

out: Continue to the next step.

Test and troubleshoot

Check caller permissions, bot permissions, channel overrides and role hierarchy separately. Test delete/ban/permission changes in a dedicated server rather than against production data.

Save, validate and publish. Perform one real test and read the first relevant log error. [Testing](/docs/flow-testing) · [Variables](/docs/flow-variables) · [Permissions](/docs/flow-permissions).