Moderation

Warns, mutes, kicks and bans with a numbered case history — 22 case types, escalation ladders, appeals on the web, reports from your members, and lockdowns that restore what they changed.

On this page

Moderation is the half of protection where a person decides. Its twin, Auto Moderation, is the half where the bot decides — and both file cases through the same engine, so a filter's action and a moderator's action look the same in a member's history.

arclo.gg/dashboard/moderation
Nebula Collective/Moderation

Moderation

Warns, mutes, kicks and bans with a full case history — plus notes, purges, lockdowns and appeals.

Every action opens a numbered case.

Enabled
GeneralPunishmentsLockdownReportsAppealsCasesLoggingCommands

Cases · 30d

128

ban 12 · mute 41 · warn 63

In force

9

Not lifted yet.

Reports waiting

3

Members can use /report.

Appeals waiting

1

Approving lifts it.

Search a reason, a name, or a case number
Ban throwaway_84
Raid participation · 3 hours ago · by Mira
#1284
Mute loud.timLifts in 55 minutes
Message spam in #general · 5 hours ago · by Arclo
#1283
Warning kito
Backseat modding · yesterday · by Nova
#1282
Unban juno
Appeal accepted · 2 days ago · by Mira
#1281

22 case types · every action numbered, appealable and logged

Setting it up

  1. Switch it on

    Essentials → Moderation. The page has 8 tabs; General is where you start.

  2. Name your moderator roles

    Who may use moderation commands. Separately, an admin tier can delete cases, run /role all and start a lockdown.

  3. Set immunity

    Immunity is per punishment type, so a role can be warnable but not bannable. Immune members are refused before anything happens — no case, no DM, no log line.

  4. Choose how a mute works

    Timeout (Discord's own, no setup, capped at 28 days per application — Arclo renews longer mutes automatically), a mute role you name, or both.

  5. Point the logger at a channel

    On the Logging tab, or from Logging.

The eight tabs

TabWhat lives there
GeneralModerator and admin roles, immunity, how a mute works, reason shortcuts, general behaviour
PunishmentsA tile per punishment: default duration, DM, announcement, immunity, escalation thresholds
LockdownWhich channels a lockdown covers, the notices it posts, and how long it lasts
ReportsWho may report, what a report must contain, where it lands, and what Arclo does about repeats
AppealsThe public appeal page, its rules, and the queue
CasesThe searchable case history and the recent-activity feed
LoggingThe Moderation logger and its per-action switches
CommandsPer-command settings and reply text

Cases

Every action opens a numbered case. There are 22 types, covering members, channels and the server itself.

Case typeWhat it recordsTimed
Warningwas warned
Mutewas mutedYes
Unmutewas unmuted
Kickwas kicked
Banwas bannedYes
Unbanwas unbanned
Softbanwas softbanned
Voice mutewas muted in voiceYes
Voice unmutewas unmuted in voice
Deafenwas deafenedYes
Undeafenwas undeafened
Voice disconnectwas disconnected from voice
Nickname changehad their nickname changed
Role givenwas given a roleYes
Role removedhad a role removed
Notehad a note added
Purgehad messages purged
Channel lockedwas lockedYes
Channel unlockedwas unlocked
Lockdownwent into lockdownYes
Lockdown liftedcame out of lockdown
Slowmodehad its slowmode changedYes
  • Case numbers are allocated atomically, so two simultaneous bans can never share one.
  • /case <number> opens a case; /modlogs <member> shows a member's whole history.
  • Bans done through Discord's own interface are picked up from the audit log and filed as cases, so the history has no holes — and the punished member gets the same DM.
  • Deleting a case removes it from the record. It does not undo what was done.

Punishments

The full order of operations — immunity, escalation, the case, the DM before the action, the expiry — is on Punishments. Per punishment, you can set:

Default duration
Used when a moderator gives no duration. Leaving a command's duration blank means use this; typing permanent means never expire.
DM the member
An editable message sent before the punishment lands.
Announce in the channel
An editable public message.
Immune roles
Per punishment.
Take their roles away
Strips a muted member's other roles and hands them back when the mute lifts. Works for every mute method, not only mute roles.
Roles on punish
Roles to add or remove when this punishment lands.
Internal reason
The template written into Discord's audit log, separate from the reason your members see.
Always review
Forces the moderator through a review form before it goes through.

Reason shortcuts

Map an alias to a full wording — spam&ldquo;Repeated spam in public channels&rdquo; — and optionally a duration. It expands inside the engine, so commands, context menus, report cards and the dashboard all get it. An explicit duration on the command still wins.

#Direct Message

ArcloBOTToday at 14:32

You were muted in Nebula Collective

Duration

1 hour

Expires

in 1 hour

Reason

Message spam in #general

You can appeal this from the link below

Appeal
The DM, sent before the punishment lands — after a ban, it could not be delivered at all.
#mod-log

ArcloBOTToday at 14:32

Member banned

Member

throwaway_84

Moderator

@Mira

Duration

Permanent

Case

#1284

Reason

Raid participation

Mira · today at 03:11

The same action in your log channel.

Privacy

Per audience — the public announcement and the DM — you choose whether to include the moderator's name, the proof, the case number and the duration. Anything withheld renders as a stand-in (&ldquo;a moderator&rdquo;) rather than as a visible gap.

Escalation

A ladder counts a member's recent cases of a type and upgrades the punishment past a threshold — three warnings in seven days becomes a mute. Each rung names its own window, so &ldquo;3 in 30 days&rdquo; really means 30 days rather than the server-wide expiry.

Automatic punishments climb the same ladder

A filter that warns somebody escalates exactly as a moderator's warning would. That is usually right — and it is a reason to be careful with a filter that fires often.

Reports

/report lets your members bring something to staff. A report card lands in the channel you choose with buttons on it.

Where reports land
The channel. Set this first — a queue with nowhere to land never reaches anybody.
Who may report
Allow and block lists, roles that cannot be reported at all, and account-age and time-in-server gates.
What a report must say
Template reasons offered by autocomplete, a minimum length, and optionally a required attachment.
Card actions
Which punishments the card's buttons offer — warn, mute, kick, ban, and clearing the member's recent messages. All are on by default.
When Arclo acts on its own
X reports about one member within Y days → do Z. Dismissed reports never count, and one report can only advance the ladder one rung.
Auto-close
Reports nobody touched are closed after a while.

The automatic actions are nine: warn, mute, kick, ban, softban, add a role, remove a role, DM the member, or simply notify staff. The last three deliberately file no case — a server that wants &ldquo;three reports and they lose the posting role, and hear why&rdquo; should not have to reach for a ban to say it.

Appeals

A banned member is not in your server: no command, no channel and no DM thread reaches them. So appeals live on a public page at /appeal/<your-server>, which they can open from the ban DM.

  1. The member fills in the form on the web page. The appeal gets its own number.
  2. Arclo posts a card into your staff channel with accept and reject buttons.
  3. Staff decide — in Discord, or from the Appeals tab on the dashboard. Either way the member is told, the punishment is lifted if you accepted, and it is logged.

Note

Appeal pages are not indexed by search engines: the contents are one person's business.

Lockdown

Locks a channel, a list of channels, or the whole server, with a notice posted in each and an optional automatic end.

Unlock restores, it does not grant

Arclo records every permission bit it changed on every channel it locked, and puts each one back. A naive unlock grants Send Messages to @everyone in channels that never had it — which is how a lockdown ends with the announcement channel open to the world.

Clearing messages

/clear deletes messages with fourteen filters as subcommands — any, from a member, bots, humans, containing text, with links, with attachments, embeds, before or after a message, and more.

Discord's 14-day wall

Discord refuses to bulk-delete anything older than two weeks, and deleting old messages one at a time is rate-limited in hours. Every purge in Arclo works inside that window; older messages are counted and reported rather than deleted.

Commands

Twenty-six slash commands, kept flat on purpose — /ban, /kick, /mute and /warn are muscle memory from every other bot — plus three user context commands and one message context command.

  • /ban <member> [reason] [duration] [delete] [silent] [evidence] [message] [review]
    Ban MembersCannot be undone

    Bans a member — permanently, or for a duration that lifts itself. Works on somebody who has already left.

  • /unban <user> [reason]
    Ban Members

    Lifts a ban. Accepts a user id or picks from the ban list.

  • /softban <member> [reason] [delete] [silent] [message] [review]
    Ban MembersCannot be undone

    Bans and immediately unbans — the way to wipe somebody's recent messages without keeping them out.

  • /kick <member> [reason] [silent] [message] [review]
    Kick Members

    Removes a member from the server. They can rejoin with a new invite.

  • /mute <member> [duration] [reason] [scope] [strip-roles] [silent] [message] [review]
    Timeout Members

    Stops a member talking — with Discord's timeout, a muted role, or both, whichever this server uses.

  • /unmute <member> [reason] [scope]
    Timeout Members

    Lets a member talk again — lifts the timeout, the muted role, or both.

  • /warn <member> <reason> [points] [silent] [evidence] [message] [review]
    Moderators

    Warns a member and records it. Crossing a threshold can mute, kick or ban them automatically.

  • /unwarn <case> [reason]
    ModeratorsCannot be undone

    Removes a single warning by its case number.

  • /hardmute <member> [duration] [reason] [scope] [silent] [message] [review]
    Timeout Members

    Mutes a member AND takes every role they have away. A temporary hardmute hands the roles back when it expires; a permanent one leaves them off.

  • /mass ban [members|name|created|joined] [full] [duration] [reason] [delete] [silent]
    Ban MembersCannot be undone

    Bans everybody in a list of members or user ids, in one go.

  • /mass kick [members|name|created|joined] [full] [reason] [silent]
    Kick Members

    Kicks everybody in a list of members, in one go.

  • /mass mute [members|name|created|joined] [full] [duration] [reason] [silent]
    Timeout Members

    Mutes everybody in a list of members, in one go.

  • /mass warn [members|name|created|joined] [full] [reason] [points] [silent]
    Moderators

    Warns everybody in a list of members, in one go. Each warning counts toward that member's own threshold ladder.

  • /deafen <member> [duration] [reason]
    Deafen Members

    Server-deafens a member so they can't hear voice channels. Optionally timed.

  • /undeafen <member> [reason]
    Deafen Members

    Lifts a server deafen.

  • /voicekick <member> [reason]
    Move Members

    Disconnects a member from voice. They can come straight back — it is a nudge, not a punishment.

  • /warnings list <member> [include-expired]
    Moderators

    Shows a member's warnings, their points and which ones have expired.

  • /warnings clear <member> [reason]
    ModeratorsCannot be undone

    Wipes every warning a member has.

  • /modlogs <member> [type] [page]
    Moderators

    The full moderation history of a member — every case, newest first.

  • /case view <case>
    Moderators

    One case in full — reason, moderator, duration, evidence and its appeal.

  • /case reason <case> <reason>
    Moderators

    Rewrites a case's reason — the fix for the one typed in a hurry.

  • /case duration <case> <duration>
    Moderators

    Changes how long a timed punishment lasts — or makes it permanent.

  • /case evidence <case> [file] [link]
    Moderators

    Attaches a screenshot or a message link to a case, so it survives the deleted message.

  • /case pardon <case> [reason]
    Moderators

    Lifts a punishment and marks the case pardoned. It stays in the history, but stops counting.

  • /case delete <case> [reason]
    AdministratorsCannot be undone

    Erases a case entirely. The history will not show it happened.

  • /case search [member] [moderator] [type] [contains] [page]
    Moderators

    Finds cases by member, moderator, type or a word in the reason.

  • /case stats [moderator] [days]
    Moderators

    How much moderating has been done, and by whom — the leaderboard for a staff team.

  • /note add <member> <note> [pin]
    Moderators

    Records a private staff note about a member. Never shown to them, and never counts as a punishment.

  • /note list <member>
    Moderators

    Every staff note about a member.

  • /note remove <member> <number>
    ModeratorsCannot be undone

    Removes one note by its number.

  • /note clear <member>
    ModeratorsCannot be undone

    Removes every note about a member.

  • /clear <count> [filter] [channel] [member] [text] [pattern] [prefix] [reason]
    Manage MessagesCannot be undone

    Deletes the last N messages in a channel — everything, or only what the filter matches (one member, bots, links, invites, images, files, embeds, pings, emoji, text, a regular expression). It can also strip every reaction and leave the messages.

  • /slowmode <interval> [channel] [duration] [reason]
    Manage Channels

    Sets or clears a channel's slowmode, optionally lifting itself after a while.

  • /lock [channel] [duration] [reason] [silent]
    Manage Channels

    Stops everyone talking in a channel. Optionally unlocks itself after a set time.

  • /unlock [channel] [reason]
    Manage Channels

    Opens a locked channel again.

  • /lockdown start [duration] [reason]
    Administrators

    Locks every channel on your lockdown list at once — the raid button.

  • /lockdown end [reason]
    Administrators

    Lifts a lockdown and restores every channel to what it was before.

  • /lockdown status
    Moderators

    Whether the server is locked down, which channels, and for how much longer.

  • /nickname set <member> <nickname> [reason]
    Manage Nicknames

    Changes a member's nickname.

  • /nickname reset <member> [reason]
    Manage Nicknames

    Clears a member's nickname, putting their username back.

  • /nickname decancer <member> [reason]
    Manage Nicknames

    Rewrites an unreadable name — fancy fonts, Zalgo, invisible characters — as plain letters.

  • /nickname freeze <member> [nickname] [reason]
    Manage Nicknames

    Locks a member's nickname where it is — Arclo puts it back if they change it.

  • /nickname unfreeze <member>
    Manage Nicknames

    Lets a member change their own nickname again.

  • /role add <member> <role> [reason]
    Manage Roles

    Gives a member a role.

  • /role remove <member> <role> [reason]
    Manage Roles

    Takes a role away from a member.

  • /role toggle <member> <role> [reason]
    Manage Roles

    Gives the role if they don't have it, takes it if they do.

  • /role temp <member> <role> <duration> [reason]
    Manage Roles

    Gives a role that takes itself away again after a set time.

  • /role all <role> <action> [only] [with-role] [reason]
    AdministratorsCannot be undone

    Gives (or removes) a role for every member at once. Runs in the background.

  • /role list [page]
    Moderators

    Every role in the server, with how many members hold each.

  • /role members <role> [page]
    Moderators

    Who holds a role.

  • /report <reason> [member] [message-link] [evidence]
    Everyone

    Reports a member — or one specific message — to the staff. The reason can be picked from this server's own list. Anybody can use it.

  • /appeal submit [case]
    Everyone

    Files an appeal against a punishment, for the staff to review.

  • /appeal status
    Everyone

    Where a member's own appeals stand.

  • /appeal list [status] [page]
    Moderators

    The appeals waiting for staff to decide.

  • /appeal review <appeal> <decision> [note]
    Moderators

    Approves or denies an appeal, lifting the punishment if it's approved.

  • Right-click a member → Apps → Moderation History
    Moderators

    Right-click a member → Apps → Moderation History

    Right-click a member → Apps → Moderation History — their full case list without typing a name.

  • Right-click a member → Apps → Warn Member
    Moderators

    Right-click a member → Apps → Warn Member

    Right-click a member → Apps → Warn Member — opens a box for the reason and files the warning.

  • Right-click a member → Apps → Report Member
    Everyone

    Right-click a member → Apps → Report Member

    Right-click a member → Apps → Report Member — files a report without a command.

  • Right-click a message → Apps → Report Message
    Everyone

    Right-click a message → Apps → Report Message

    Right-click a message → Apps → Report Message — reports the message and its author together, with the text attached.

Still stuck? Ask in the support server — somebody there has almost certainly configured this before.