Moderation
DocsModeration

Moderation

Use cases, warnings, timeouts, bans, purges, and lockdowns safely.

How moderation works

Appear uses Discord's native ban, kick, timeout, message deletion, channel overwrite, and role systems. Moderation commands enforce their listed user and bot permissions, then Discord applies hierarchy rules.

Core actions

moderation

,warn

Warns a member and records it as a case in their moderation history. Nothing is taken away from them - it is a logged note. You cannot warn yourself or the bot.

,warn <user> [reason]
Example,warn @user reason
Arguments
userRequired
reasonOptional
User permissionsManage Messages
Open in command browser
moderation

,mute

Time out a member for a duration.

,mute [user], [duration], [reason]
Example,mute @user 10m spam
Arguments
inputOptional
User permissionsModerate Members
Bot permissionsModerate Members
Open in command browser
moderation

,kick

Kick a member from the server.

,kick [user], [reason]
Example,kick @user spam
Arguments
inputOptional
User permissionsKick Members
Bot permissionsKick Members
Open in command browser
moderation

,ban

Ban a member from the server.

,ban [user], [reason]
Example,ban @user raiding
Arguments
inputOptional
User permissionsBan Members
Bot permissionsBan Members
Open in command browser
moderation

,purge

Deletes a selected amount or type of messages.

,purge <amount>
Example,purge 10
Arguments
amountRequired
User permissionsManage Messages
Bot permissionsManage Messages
Open in command browser

Message cleanup

purge supports focused variants for bots, humans, links, images, attachments, emoji, ranges, and more. Discord bulk deletion only works on messages under 14 days old, and the specialized variants document their scan and deletion limits.

moderation

,purge bots

Deletes recent bot messages in this channel, along with human messages that begin with the server prefix, so command invocations go with the replies they triggered. Defaults to 50 messages.

,purge bots [amount]
Example,purge bots 10
Arguments
amountOptional
User permissionsManage Messages
Bot permissionsManage Messages
Open in command browser
moderation

,purge links

Deletes recent messages containing a link - anything with `http://`, `https://`, or `discord.gg/`. Defaults to 50 messages.

,purge links [amount]
Example,purge links 10
Arguments
amountOptional
User permissionsManage Messages
Bot permissionsManage Messages
Open in command browser
moderation

,purge images

Deletes recent messages that have an image attachment (png, jpg, jpeg, gif, webp) or a direct link to one. Search defaults to the last 100 messages and can be raised up to 1000; at most 100 messages are deleted per run and only those under 14 days old.

,purge images [search]
Example,purge images 10
Arguments
searchOptional
User permissionsManage Messages
Open in command browser
moderation

,purge between

Deletes messages sent between two messages, inclusive of both. Each accepts a message ID or a full message link, and the order you give them does not matter. At most 100 messages are deleted per run and only those under 14 days old.

,purge between <start> <finish> [search]
Example,purge between start finish 10
Arguments
startRequired
finishRequired
searchOptional
User permissionsManage Messages
Open in command browser

Channel lockdowns

A lockdown removes Send Messages from the configured lockdown role. Set the role first. Server-wide lockdown skips channels on the ignore list and processes channels gradually to stay within Discord rate limits.

moderation

,lockdown role

Sets which role gets its Send Messages permission removed when the server is locked down. Without this, lockdown has no role to act on.

,lockdown role <role>
Example,lockdown role @role
Arguments
roleRequired
User permissionsManage Guild
Open in command browser
moderation

,lockdown

Locks the current channel by denying the lockdown role permission to send messages. Everything already posted stays visible. Use `unlock` to reverse it.

,lockdown
User permissionsManage Channels
Bot permissionsManage Channels
Open in command browser
moderation

,lockdown all

Locks every text channel in the server at once, skipping any channel added with `lockdown ignore`. Channels are locked one at a time to stay inside Discord's rate limits, so a large server takes a moment.

,lockdown all
User permissionsManage Channels
Bot permissionsManage Channels
Open in command browser
moderation

,lockdown ignore add

Marks a channel to be skipped by a server-wide lockdown, so it stays usable while everything else is locked. Useful for a staff or announcements channel.

,lockdown ignore add <channel>
Example,lockdown ignore add #channel
Arguments
channelRequired
User permissionsManage Guild
Open in command browser