Purge

#Overview

Purge deletes recent messages in the channel you run it in. You can clear everything, or pick which ones go: one person's messages, bot messages, links, images, messages with a certain word, and more. You can also take reactions off messages without deleting them.

#Getting started

1. Go to the channel. Purge works on the channel you type it in.

2. Pick what to clear. /purge all with a number clears that many messages. Any other filter clears the last 100 that match if you don't give a number.

3. Run it. Utilities shows "Purging messages..." while it works, then says how many it purged. That line removes itself a second later. If you used the prefix, your command message is deleted too.

/purge all 50
/purge user @someone
/purge bots

With the prefix, a number on its own clears that many, and a name or mention clears that person's messages:

,purge 50
,p 50
,p @someone 20

#Filters

Every filter takes an amount from 1 to 500. Leave it out and it clears up to 100.

#Words

contains, startswith and endswith ignore capital letters, so hello also matches Hello. With the prefix, everything after the command is the text to match, so ,purge contains hello there looks for "hello there" and clears up to 100. Use the slash command if you want to set an amount.

#Before, after and between

These take a message link or a message ID. Right-click a message and copy either one. For between, the two messages can be given in any order. The messages have to be in the channel you run the command in.

/purge after https://discord.com/channels/123/456/789
/purge between 1234567890123456789 1234567890987654321

#Bots

/purge bots (or ,pb) clears up after bots in one go. It takes:

• every message sent by a bot,
• every message a bot replied to,
• every message that looks like a bot command: one that starts with , ! ? . $ % + ; & / or your server's own prefix, followed straight away by a short word.

It also clears the channel's snipes, so the bot spam can't be read back with /snipe. Other purges leave snipes alone.

#Reactions

/purge reactions takes the reactions off recent messages that have any. The amount is how many messages to clear, up to 100. Unlike deleting, this works on messages of any age.

#Good to know

• Permissions. You need Manage Messages. Utilities needs Manage Messages and Read Message History in the channel.
• 500 at most. One purge deletes up to 500 messages.
• 14 days. Discord doesn't let bots bulk-delete messages older than 14 days, so those are skipped. The reply tells you how many were actually deleted, which can be fewer than you asked for.
• How far back it looks. A filtered purge looks through up to 5,000 recent messages to find matches.
• One at a time. If you run two purges in the same channel, the second one waits for the first to finish.
• Snipe. Purged messages still show up in snipe, except the ones purge bots takes.

#Commands