# How to bulk delete messages on Discord

> How to bulk delete messages on Discord: the 14-day limit, the 100-message cap, permissions needed, safe workflows and what to do with older messages.

URL: https://www.jalkarna.in/based/learn/how-to-bulk-delete-messages-on-discord/  
Last updated: 2026-11-16

Discord has no built-in "delete all" button, so bulk deletion is done through a bot or the API. Discord's bulk delete endpoint can remove 2 to 100 messages at once, but only messages newer than 14 days; older messages must be deleted one by one. Anyone doing the cleanup needs the Manage Messages permission.

## What is Discord's 14-day bulk delete limit?

Discord's developer documentation for the [bulk delete messages endpoint](https://discord.com/developers/docs/resources/channel#bulk-delete-messages) states that bots can delete between 2 and 100 messages in one request, and that messages older than 2 weeks cannot be bulk deleted. If a request includes an older message, the call fails. This is a platform rule, so no bot can bypass it.

Bots work around it by splitting the job: recent messages go through the fast bulk endpoint, and older messages are removed individually. Individual deletion is much slower because Discord rate-limits it, so very large cleanups of old content can take a long time.

## How do you bulk delete messages?

1. Confirm you have Manage Messages and that the bot you use has it in that channel too. See [how Discord permissions work](https://www.jalkarna.in/based/learn/how-discord-permissions-work/).
2. Decide exactly what to remove: all messages, one person's, only bot output, or only attachments.
3. Start with a small number to confirm the filter does what you expect.
4. Run the command, then check the channel.
5. Record what you removed and why in your staff log.

## When should you bulk delete messages?

- Cleaning up after a spam or scam wave. See [how to stop spam and scam links](https://www.jalkarna.in/based/learn/how-to-stop-spam-and-scam-links-on-discord/).
- Removing a banned member's recent messages.
- Clearing bot command clutter from a channel.
- Removing messages that leaked personal information.

Deletion is not reversible, and Discord does not restore deleted messages. If a message might be needed as evidence, for example in a harassment case, save screenshots and message links first.

## What are the alternatives to bulk deleting?

| Option | Use when |
|---|---|
| Bulk delete recent messages | Spam or clutter within the last 14 days |
| Delete messages individually | Only a few messages, or messages older than 14 days |
| Clone or recreate the channel | You want to wipe all history; this loses channel-specific settings unless copied |
| Timeout or ban the sender | You want the behavior to stop, not just the evidence |

Channel recreation is blunt: you lose message history for everyone and need to rebuild permissions and integrations, so use it only when the history is worthless.

## What are common mistakes?

- Expecting to delete messages older than 14 days with one command.
- Deleting before capturing evidence.
- Granting Manage Messages too widely.
- Running a broad filter on a busy channel without testing it first.
- Cleaning up without stopping the source, so the spam returns.

For safer team habits, see [Discord moderation best practices](https://www.jalkarna.in/based/learn/discord-moderation-best-practices/).

## Doing this with Based

Based's manual message deletion module is off by default. It requires Manage Messages and View Channel and Read Message History, and it only acts when an authorized moderator runs a command. There is no automatic retention purging. `/pa` removes attachments, embeds, bot messages, and command-like messages, with a `limit` option. `/clear` removes messages from up to five selected users, and attachment cleanup is only included if the server enabled it and the moderator adds the `include_attachments` option. Based keeps its own messages by default when clearing attachments, and each request scans at most 100 messages by default. Every slash command also works with the "." prefix, for example `.pa`. See the [message cleanup docs](https://www.jalkarna.in/based/docs/message-cleanup/) and the [permissions docs](https://www.jalkarna.in/based/docs/permissions/).

## FAQ

### Can I delete all messages in a Discord channel at once?

Not with one built-in action. Bulk delete handles up to 100 messages newer than 14 days per request, and older ones must be removed individually or by recreating the channel.

### Why can't bots delete messages older than 14 days in bulk?

It is a Discord API restriction. Bots can only bulk delete messages newer than two weeks, so cleanup tools fall back to slower one-by-one deletion for older messages.

### What permission is needed to delete other people's messages?

Manage Messages. The person running the command and any bot performing the deletion both need it in that channel.

### Can deleted Discord messages be recovered?

No. Once deleted, messages cannot be restored by moderators or bots, so save evidence first if you might need it.

## Related
- [How to stop spam and scam links on Discord](https://www.jalkarna.in/based/learn/how-to-stop-spam-and-scam-links-on-discord/)
- [Discord moderation best practices](https://www.jalkarna.in/based/learn/discord-moderation-best-practices/)
- [How Discord permissions work](https://www.jalkarna.in/based/learn/how-discord-permissions-work/)
- [What is content moderation?](https://www.jalkarna.in/based/learn/what-is-content-moderation/)
