Skip to main content
Whether a bad actor just flooded your server with spam or a conversation took a sharp turn for the worse, /purge lets you clean up a channel in seconds — no tedious manual deleting required.

Description

The /purge command bulk-deletes a specified number of recent messages from a channel. By default it targets the channel the command is run in, but you can point it at any channel in your server. You can also narrow the deletion to messages from a specific user, making it easy to remove one person’s spam without wiping out everyone else’s conversation. Deletions are subject to Discord’s 14-day bulk-delete limit — messages older than 14 days must be removed manually.

Usage

/purge 50

Parameters

amount
number
required
The number of messages to delete. Accepts a value between 1 and 100. Messages are deleted starting from the most recent and working backwards.
user
@mention
Filter deletions to messages sent by a specific member. When provided, Burger Bot scans the specified amount of recent messages and deletes only those sent by the target user. Other members’ messages are left untouched.
channel
channel
The channel to purge messages from. Defaults to the channel where the command is run if not specified. Accepts a #channel mention.

Permissions Required

RoleAccess
Moderator or higher✅ Can purge messages
Regular members❌ No access

Example Usage

Delete the last 50 messages in the current channel:
/purge 50
Delete the last 100 messages from a specific user in the current channel:
/purge 100 @ChaosGremlin
Delete the last 25 messages in a specific channel:
/purge 25 #general
Delete the last 30 messages from a specific user in a specific channel:
/purge 30 @ChaosGremlin #general
Discord only allows bulk deletion of messages that are less than 14 days old. Messages older than 14 days cannot be removed with /purge and must be deleted manually. If Burger Bot encounters messages beyond this limit, it will delete as many eligible messages as possible and notify you of any it couldn’t remove.
Running /purge with a user filter is a great way to clean up a spam attack without disrupting the surrounding conversation. Instead of wiping the entire channel, you can surgically remove just the offending messages and leave the legitimate discussion intact.