Core Features

Purge

Clean up your server efficiently with advanced filtering and safety controls.

Table of Contents

  1. Overview
  2. Quick Start
  3. Command Parameters
  4. Filters
  5. Safety & Limits
  6. Permissions
  7. Common Errors
  8. Best Practices
  9. Examples
  10. Support

Overview

Clean up your Discord server with powerful message deletion tools:

  • Manual Purge (/purge) - Delete messages on-demand with filters
  • AutoPurge (/autopurge) - Schedule automatic message cleanup

Quick Start

Manual Purge

# Delete last 50 messages
/purge amount:50

# Delete from specific user
/purge amount:20 target:@username

# Delete bot messages only
/purge amount:100 type:Bot Messages

AutoPurge

# Basic auto-purge setup
/autopurge action:setup channel:#general interval:1h amount:50

# With filters and logging
/autopurge action:setup channel:#spam interval:30m amount:100 type:Bot Messages log_channel:#logs

Command Parameters

/purge Parameters

ParameterRequiredDescriptionRange/Options
amountYesMessages to delete2-200 (default)
2-500 (moderator)
2-1000 (admin)
targetNoSpecific user@mention
typeNoFilter typeSee Filters
inputConditionalMessage ID or search textRequired for text/position filters

/autopurge Parameters

ParameterRequiredDescriptionExample
actionYesOperation typesetup/disable/remove/status
channelFor setup/disable/removeTarget channel#general
intervalFor setupPurge frequency30s, 5m, 1h, 2d
amountFor setupMessages per cycle2-500 (default: 100)
targetNoTarget user@mention
filter_typeNoMessage filterSame as /purge type
filter_inputNoSearch text/IDRequired for text filters
log_channelNoLogging channel#mod-logs
AutoPurge Limits:
  • Maximum 2 channels per server
  • Minimum interval: 30 seconds
  • Maximum interval: 30 days

Filters

Content Filters

Bot Messages

/purge amount:50 type:Bot Messages

User Messages

/purge amount:50 type:User Messages

Webhook Messages

/purge amount:50 type:Webhook Messages

Text Messages Only

/purge amount:50 type:Text Messages Only

Media & Embeds

Messages with Embeds

/purge amount:50 type:Messages with Embeds

Messages with Attachments/Images

/purge amount:50 type:Messages with Attachments/Images

Messages with Links

/purge amount:50 type:Messages with Links

Messages with Emojis

/purge amount:50 type:Messages with Emojis

Interactions

Messages with Mentions

/purge amount:50 type:Messages with Mentions

Messages with Reactions

/purge amount:50 type:Messages with Reactions

User Attributes

Messages from 0 Role Members

/purge amount:50 type:Messages from 0 Role Members

Messages from No Avatar Members

/purge amount:50 type:Messages from No Avatar Members
Text search filters require the input parameter to specify what to search for.

Contains Text

/purge amount:50 type:Contains Text input:spam

Matches Text Exactly

/purge amount:50 type:Matches Text Exactly input:!help

Starts With Text

/purge amount:50 type:Starts With Text input:!

Position-Based

Position filters require the input parameter with a valid message ID. Right-click any message and select "Copy Message ID" (Developer Mode required).

Messages BEFORE Input ID

/purge amount:50 type:Messages BEFORE Input ID input:1234567890

Messages AFTER Input ID

/purge amount:50 type:Messages AFTER Input ID input:1234567890

Safety & Limits

Automatic Protections

  • Pinned messages are never deleted
  • System messages are automatically skipped
  • Messages older than 14 days cannot be bulk deleted (Discord limitation)
  • Permission checks run before every operation

Large purge operations (100+ messages) require explicit confirmation

Message Scan Limits

To maintain performance, the bot limits how many messages it scans:

Filter TypeScan Limit
Text search (contains/matches/starts)3,500 messages
Target user specified2,500 messages
No filters2,000 messages

Rate Limits

The bot automatically handles Discord's rate limits:

  • 0.5 second delay between deletion batches
  • 100 messages per batch maximum
  • Automatic retry on temporary failures

Permissions

Required User Permissions

Manage Messages

Required Bot Permissions

Manage MessagesRead Message History
If the bot lacks required permissions, you'll receive an error message explaining what's missing.

Common Errors

Invalid Message ID

Missing Filter Input

14-Day Bulk Delete Limit

AutoPurge Configuration Limit


Best Practices

Efficient Cleanup Strategies

  • Start small: Test with 10-20 messages before large purges
  • Use specific filters: Combine target with type for precision
  • Check confirmation: Review filter summary before confirming large purges
  • Consider timing: Purge during low-activity hours for less disruption

Filter Combinations

Combine multiple filters for targeted cleanup:

# Remove only bot messages from specific user
/purge amount:50 target:@BotName type:Bot Messages

# Clear user messages containing links
/purge amount:100 target:@Username type:Messages with Links

# Remove emoji-only messages from users without roles
/purge amount:30 type:Messages with Emojis

Examples

Manual Purge Scenarios

# Clean up bot spam
/purge amount:100 type:Bot Messages

AutoPurge Scenarios

# Auto-clean general chat every hour
/autopurge action:setup channel:#general interval:1h amount:50

Support

Having trouble with purge operations? Join our support server or check the FAQ for common solutions.