Command Guide
Everything you need to know about using DumpsterBot in your Discord server. All commands use Discord's slash command system - type /dump in any channel to open the dashboard and start cleaning up.
Dumping Messages
Bulk-delete messages with powerful filters. Pinned messages are always skipped by default.
/dumpOpen the interactive delete dashboardOpens an interactive dashboard right in Discord. /dump takes no arguments — you choose a target and any filters from the dashboard, run a dry-run preview to see the exact matches, and confirm before a single message is deleted. Messages older than 14 days are handled automatically.
| Dashboard option | Required | Description |
|---|---|---|
target | Required | What to delete: the last N messages, or from a specific message ID (before, after, or around that boundary). |
user | Optional | Only delete messages from this user. |
contains | Optional | Only delete messages whose content contains your keywords. |
time_window | Optional | Only delete messages sent within a time window. |
role | Optional | Only delete messages from members of this role. |
attachment_type | Optional | Only delete messages with images, videos, or files. |
bot_only | Optional | Only delete messages posted by bots. |
exclude_user | Optional | Skip messages from this user. |
include_pinned | Optional | Include pinned messages (skipped by default). |
dry_run | Optional | Preview the exact matches without deleting (free, no credits used). |
/undo-dumpRestore your most recent dumpRestores the messages from your most recent dump. Available for 15 minutes after a dump — the bot re-posts each deleted message as an embed showing its original author and content. Undo does not consume credits.
Scheduled Dumps
Recurring automatic cleanup on a schedule you choose. Each scheduled dump deducts credits like a manual one (1 credit per deleted message).
/dump-scheduleSet up a recurring dumpSet up a recurring dump on a channel. Choose a frequency — hourly, daily, or weekly — plus the same filters as a manual dump, and the bot runs it automatically. No cron to configure.
/dump-listView and manage scheduled dumpsView and manage your server's scheduled dumps — see what's running and pause or remove any schedule.
Account & Info
Check your balance, track usage, and get help.
/creditsView your credit balanceShows your server's current credit balance and a link to buy more. Every server starts with 2,000 free credits.
/statsUsage at a glanceYour usage summary: total messages deleted, recent activity, and an estimated 30-day runway based on current usage.
/helpList all commandsLists every DumpsterBot command with a short description.
Credits & Pricing
DumpsterBot runs on prepaid credits — 1 credit deletes 1 message. Every server starts with 2,000 free credits (one-time, no card needed). Every feature is available to every server: no tiers, no subscriptions.
Top-up packs are one-time purchases and credits never expire. Run /credits to check your balance and get the buy link.
Permissions
Give the bot these Discord permissions when you invite it, and make sure the right people can run it.
- View Channel
- Read Message History
- Manage Messages
- Send Messages
- Embed Links
Any member with the Manage Messages permission can run /dumpand manage schedules. Everyone else won't see the command.