Skip to main content
You must have the Manage Channels and Manage Messages permissions.

​
Usage

Syntax
Example
<> marks a required argument, [] marks an optional one. Don’t type the brackets themselves. See Arguments for quoting, flags, and everything else.
The interval must be at least 1 hour and at most 14 days. See Durations for accepted inputs.

​
Flags

Flags combine with AND, so a message has to match all of them to be removed. Add -or to remove messages matching any of them instead.

​
Matching content

​
Matching author

​
Matching text

Pass multiple terms by separating them with | or ,. For example, --contains leaked|leaking matches either word.

​
Modifiers

​
Behavior

  • A channel can only have one scheduled purge at a time. Running purge add on a channel that already has one replaces the old settings.
  • The first purge runs one full interval after you set it up, not immediately.
  • Pinned messages are never removed, no matter which flags are set.
  • --amount is how many recent messages the bot searches through on each run. If more messages were sent during the interval than the amount, only the most recent ones get checked and the rest are left alone. Raise it on busy channels.
Discord only allows bots to bulk delete messages under 14 days old. Anything older is skipped and stays in the channel. This is a Discord limitation, not something the bot can work around, and it’s why the interval caps out at 14d.
Last modified on August 4, 2026