/ban is your final word. Banning removes a member permanently and prevents them from ever rejoining your server — and you can clean up their message history at the same time.
Description
The/ban command permanently bans a member from your server, blocking them from rejoining via any invite link. In addition to removing the member, you can optionally instruct Discord to delete up to 7 days of their message history across all channels — handy for cleaning up spam, harassment, or other content you want wiped quickly. The ban and reason are logged in Burger Bot’s records. Banned users can be reinstated at any time using /unban.
Usage
Parameters
The server member you want to ban. Must be an
@mention of a current member of your server.A clear explanation for the ban. This is logged in Burger Bot’s moderation records and displayed to other administrators. Given the severity of a ban, providing a reason is strongly recommended.
The number of days of message history to delete for the banned member, across all channels. Accepts a value between
0 and 7.| Value | Behaviour |
|---|---|
0 | No messages deleted (default) |
1 | Delete last 1 day of messages |
7 | Delete last 7 days of messages |
Permissions Required
| Role | Access |
|---|---|
| Administrator or configured Admin role | ✅ Can ban members |
| Moderator | ❌ No access |
| Regular members | ❌ No access |
Example Usage
Ban a member with a reason:Message deletion via
delete_messages is permanent and irreversible. Discord removes those messages from all channels simultaneously. If you’re unsure whether you need to delete messages, start with 0 — you can always use /purge to clean up specific channels afterward.