EazyAutodelete provides powerful and flexible configuration options that allow you to customize the deletion algorithm precisely to your needs. Whether you want simple time-based deletion or complex multi-filter rules, you have complete control over how messages are handled in your channels.
A configuration (or "config") is a set of rules that defines:
- When messages should be deleted (mode and limit)
- Which messages should be deleted (filters)
- How filters work together (filter behavior)
- Whose messages are affected (role filtering)
- Where in the message timeline to operate (time boundaries)
Each config is channel-specific and operates independently from other configs, even within the same channel.
These are the fundamental settings every config must have:
Determines HOW the deletion algorithm works:
- Mode 0: Disabled (no deletion)
- Mode 1: Delete each message after X time individually
- Mode 2: Delete all messages every X time (bulk intervals)
- Mode 3: Delete all messages after X message count
- Mode 4: Currently unavailable
Example use cases:
- Mode 1 for self-destructing temporary channels
- Mode 2 for scheduled bulk cleanup
- Mode 3 for maintaining specific message history length
Sets the time or count that triggers deletion:
- For Modes 1 & 2: Time duration (10 seconds to 7 days)
- For Mode 3: Message count (3 to 75 messages)
Format examples:
30s = 30 seconds
5min = 5 minutes
2hrs 30min = 2 hours and 30 minutes
50 = 50 messages (Mode 3 only)
Control exactly which messages are targeted for deletion:
Select from 20+ different message characteristics:
- Content type (emojis, links, attachments)
- Author type (bot vs human)
- Message status (pinned, has thread, is reply)
- Announcement features (published, crosspost)
- And more!
Examples:
- Only delete bot messages
- Only delete messages with attachments
- Only delete unpinned messages (protect pins)
- Only delete messages without links
Control how multiple filters work together:
- Match ONE (OR logic): Delete if message matches ANY filter
- Match ALL (AND logic): Delete only if message matches ALL filters
Example:
- Filters: "Contains Links" + "Author is Bot"
- Match ONE: Deletes messages with links OR from bots
- Match ALL: Deletes only messages with links AND from bots
Fine-tune your configuration with these optional settings:
👥 Roles - Control whose messages are affected:
- Target roles: Only delete from users with these roles
- Ignore roles: Never delete from users with these roles
- Up to 10 roles (20 with Premium)
Use cases:
- Protect moderator messages
- Target temporary member roles
- Exclude VIP/supporter roles
- Create staff-only channels
Control which messages in the timeline are processed:
⏩ Delete messages after - Only delete messages sent after a specific message ID
- Preserves older conversation history
- Creates a temporal starting point
- Useful for phased rollout
⏪ Delete messages before - ⚠️ Deprecated feature
- No longer available
- Historical reference only
📡 Load old messages - Decide whether to process existing messages:
- Yes: Process messages from the past 2 weeks
- No: Only process new messages going forward
- Critical decision when creating/modifying configs
- Navigate to your channel where you want auto-deletion
- Run
/setup command
- Select "Create Config" from the menu
- Choose your mode (1, 2, or 3)
- Select filters (optional but recommended)
- Set filter behavior (ALL or ONE)
- Configure roles (optional)
- Set the limit (time or count)
- Choose whether to load old messages
- Wait 60 seconds for activation
- Run
/setup in the channel with the config
- Select the config you want to modify
- Choose "Edit Config"
- Modify any settings as needed
- Confirm changes
- Wait 60 seconds for changes to take effect
- Run
/setup in the channel
- Select the config to delete
- Choose "Delete Config"
- Confirm deletion
- Config stops immediately
You can have up to 3 configs per channel (more with Premium), allowing sophisticated deletion strategies:
Example 1: Dual-Purpose Chat
- Config 1: Mode 1, 1 hour, all messages → Regular chat cleanup
- Config 2: Mode 1, 5 minutes, filter "Author is Bot" → Fast bot command cleanup
Example 2: Selective Preservation
- Config 1: Mode 1, 30 minutes, all messages except pinned → General cleanup
- Config 2: Mode 2, 1 day, filter "Contains Links" + "Author is Bot" → Bot link cleanup
Example 3: Role-Based Tiers
- Config 1: Mode 1, 10 minutes, target "Trial Member" role → Quick cleanup for trials
- Config 2: Mode 1, 1 hour, ignore "Moderator" role → Preserve mod messages longer
✅ Do:
- Use different modes for different purposes
- Combine filters strategically
- Test each config individually first
- Document your multi-config strategy
- Use
/debug to monitor all configs
❌ Don't:
- Use multiple Mode 3 configs in one channel (causes conflicts)
- Create overlapping configs that fight each other
- Forget which config does what
- Make them too complex to understand
- Start simple: Begin with one Mode 1 config and basic filters
- Test in test channel: Always test new configs before production use
- Use common filters: Start with "Is not pinned" to protect important messages
- Choose conservative limits: Start with longer times, shorten if needed
- Don't load old messages initially: Test on new messages first
Temporary Chat Channel:
Mode: 1 (Individual time-based)
Limit: 1hrs
Filters: Is not pinned
Load old: No
Bot Command Cleanup:
Mode: 1 (Individual time-based)
Limit: 30s
Filters: Author is Bot
Load old: Yes
Announcement Channel:
Mode: 2 (Interval-based bulk)
Limit: 7days
Filters: None (all messages)
Load old: No
Media Channel:
Mode: 3 (Count-based)
Limit: 50 messages
Filters: Has Attachment(s)
Load old: Yes
Config not deleting anything?
- Check Mode (is it set to 0?)
- Verify permissions (View, Read History, Manage Messages)
- Review filters (too restrictive?)
- Check
/debug for errors
- Wait for 60-second activation delay
Config deleting wrong messages?
- Review Filter Behavior (ALL vs ONE)
- Check which filters are active
- Verify role configuration
- Test in test channel to confirm behavior
Config keeps resetting to Mode 0?
- Bot is detecting an error
- Check permissions in the channel
- Verify role configuration is valid
- Review
/debug for error messages
- See Troubleshooting Guide
| Setting |
Purpose |
Options/Range |
| Mode |
Deletion algorithm |
0, 1, 2, 3 |
| Limit |
When to delete |
10s - 7d OR 3-75 msgs |
| Filters |
What to delete |
20+ options |
| Filter Behavior |
Filter logic |
ALL or ONE |
| Roles |
Whose messages |
10-20 roles |
| Time Boundary |
Message timeline |
Message ID or 0 |
| Load Old Messages |
Process history |
Yes or No |
Configuring EazyAutodelete to perfectly match your needs can take some experimentation. Don't hesitate to:
- Read the detailed documentation for each setting
- Test configurations in test channels
- Join our Support Server for assistance
- Check the Troubleshooting Guide
- Share your configs and learn from others
Happy configuring! 🎉