Skip to main content

Ban Messages

The ban-message editor controls the presentation used by Kakashi's moderation ban flow. It does not change who can ban, bypass Discord hierarchy or change the reason recorded for the moderation action.

Supported content​

The current editor can customize ordinary message content and embed presentation including:

  • author;
  • author image;
  • color;
  • description;
  • image.

Variables​

{user}
{user.tag}
{user.avatar}
{reason}
{server.name}
{server.icon}
{mod}
{mod.avatar}

Example idea:

{user.tag} was banned from {server.name}.
Reason: {reason}
Moderator: {mod}

Use the editor's preview/view flow to confirm the final result.

warning

A public-looking ban message should not be your only moderation record. Keep the actual reason concise and useful to staff; presentation and moderation context serve different purposes.

Permission behavior​

The ban message does not grant moderation rights. /mod ban still checks the moderator's permission, Kakashi's Ban Members capability and Discord hierarchy/bannability rules.

Common mistakes​

  • Expecting the custom message to run for bans performed manually by another bot/user rather than Kakashi's own moderation flow.
  • Using an unsupported placeholder.
  • Assuming a custom message can bypass a hierarchy failure.
  • Putting sensitive staff-only information into a message that is intended for a public channel.