Purges Commands

Complete guide to Purges module commands and features

🧹 Purges Commands

Admin only:

/purge : deletes all messages between this and the replied-to message. The reason is optional and is shown in the confirmation.
/del: deletes the message you replied to.

Examples:

Delete all messages from the replied message, until now. -> /purge

Range Deletion with purgefrom/purgeto: When you need more control over the deletion range:

Reply to the first message in the range: /purgefrom The bot will confirm the message is marked (expires after 30 seconds). Only one mark can be active per chat. It is shared by all admins, so another /purgefrom is refused until /purgeto is used or the 30-second mark expires, and any admin’s /purgeto uses it.
Reply to the last message in the range: /purgeto (optionally followed by a reason, shown in the confirmation) All messages between the two markers (inclusive) will be deleted.

This is useful when you can’t easily scroll to the starting point or need to verify the range before deletion.

Limits and Restrictions:

Maximum messages per purge: 1000 messages
Message age limit: Messages older than 48 hours may not be deletable (Telegram API restriction)
Permissions required: Both the user and the bot must have “Delete Messages” permission

Module Aliases

These are help-menu module names, not command aliases.

This module can be accessed using the following aliases:

purge
del

Available Commands

Command	Description	Disableable
`/del`	Delete the replied message	❌
`/purge`	Purge messages from replied message to current, with an optional reason	❌
`/purgefrom`	Mark start point for a purge range	❌
`/purgeto`	Purge messages from marked start to this message, with an optional reason	❌

Usage Examples

Basic Usage

/del
/purge
/purge spam cleanup
/purgefrom

For detailed command usage, refer to the commands table above.

Required Permissions

All commands in this module require admin permissions with Delete Messages in the group, for both the user and the bot (the group creator always passes the user check).

Bot Permissions Required:

Admin with Delete messages

Technical Notes

Notes:

The /purgefrom marker expires after 30 seconds if not followed by /purgeto
Deleting large ranges uses concurrent processing for better performance
Status messages (showing how many messages were deleted) auto-delete after 3 seconds
The bot handles already-deleted messages gracefully without errors