Moderation Guide

sushii keeps a running log of every moderation action in your server — whether you use sushii's commands or Discord's built-in tools. Every ban, kick, and timeout gets logged as a numbered case you can reference, edit, and pull up in a member's history.

Setup

Before anything else, point sushii at a private moderation log channel via /settings → Logging → Mod log. Click Edit and pick a channel. Once set, every case will be posted there automatically.

Native Discord actions are also logged

Bans, kicks, and timeouts done through Discord's own menus become cases too, as long as sushii has the View Audit Log permission. If you entered a reason, sushii copies it into the case.

How cases work

Every action creates a case with a sequential number (e.g. "case #42"), posted to your mod log channel.

/history user:@member
/reason case:42 reason:Correct reason here
/note users:@member note:Internal note text
/uncase case:42

/history — full moderation history for a member
/reason — edit a reason after the fact. Turn on update_dm to also update the DM the member got
Mod log entries have Set reason (no reason yet) or Edit reason, for any action type (Set note / Edit note on notes), plus Delete DM while the member's DM still exists. Delete DM asks you to confirm on the entry itself. Older entries get these buttons the first time they're edited
/note — private mod note, never shown to the member or mentioned in any DM
/uncase — permanently removes a case from a member's history

Uncase is permanent

/uncase cannot be undone. Use it only to remove cases that were created in error, not to clean up a member's history before a ban appeal.

Reason templates

Save reasons you use often as templates. Every mod in the server can use them.

/reason-templates lists them, most used first. Add, edit or delete them there. A server can have up to 100.
The reason option on /ban, /warn, /timeout and the other action commands lists templates and the last few reasons used when it's empty. Once you type, it only searches templates.
Give a template a shortcut such as spam, then start a reason with !spam. Anything after the shortcut is added to the end: !spam also in #general.
A case keeps the full text. Editing or deleting a template later doesn't change past cases.
If you mistype a shortcut, the reason is saved as you typed it, with a warning. Use Edit reason to fix it.

Reason forms have a Template dropdown. These are the mod log's Set reason form and the action buttons on AutoMod alerts and member screening. The first option repeats the last reason any mod used, which helps when several mods handle a raid. Text you type is added after the template. Tick Save as template to save the result.

After an action

The reply to /ban, /warn and the other action commands has buttons for 15 minutes:

Edit reason (or Add reason) changes the reason on every case from that action and updates the mod log. Tick Also update the DM to change the DM the member got.
Delete DM removes the DM the member got. The case and its reason stay.
Save as template appears once the same reason has been used 3 or more times and isn't a template yet.

After 15 minutes, change a case from its mod log entry or with /reason.

When to use native Discord vs. sushii commands

Both approaches log to the same place. Reach for sushii commands when:

You need to act on multiple members at once (up to 25 in a single command)
You want to DM the member a reason before kicking or banning them
You need a ban that lifts automatically (/tempban)
You're banning someone who's no longer in the server (/ban accepts user IDs)

Otherwise, Discord's built-in tools work fine.

Taking action

Warnings and timeouts

/warn users:@member reason:Spamming in #general
/timeout users:@member duration:1h reason:Continued rule violations
/untimeout users:@member reason:Resolved

/warn always DMs the member — if the DM fails because they have DMs closed, it's noted in the mod log.

Kicks and bans

/kick users:@member reason:Trolling
/ban users:@member reason:Harassment dm_reason:Yes
/unban users:@member reason:Appeal accepted
/tempban users:@member duration:7d reason:Evading previous ban
/tempban-list

By default, sushii DMs the reason for bans but not for kicks. Change the defaults with the Ban and Kick rows in /settings → Moderation, or set dm_reason to override them for a single action. /tempban-list shows active temporary bans.

Cross-server ban lookup

/lookup user:123456789

Checks whether a user ID appears in ban lists shared by other servers using sushii. Useful when vetting new members or checking if someone has been actioned elsewhere.

The command is available to servers that are Discord-discoverable with 1,000+ members, or that are Discord-partnered or verified.

Sharing is opt-in

By default, your server's name and ban reasons are hidden when other servers run /lookup. To share them, go to /settings → Moderation and click Turn on next to Lookup sharing. Both servers need to have this turned on before either can see the other's details — if one hasn't, the entry shows as anonymous.

Cleanup

/prune max_delete_count:100 user:@member
/slowmode duration:30s
/slowmode duration:0

/prune deletes recent messages in the current channel — filter to a specific user to clear a raider or spammer without removing everyone else's messages. /slowmode sets or clears channel slowmode without going into channel settings; pass 0 to disable.

Moderation Guide

On this page