Warning

This document is for Red's development version, which can be significantly different from previous releases. If you're a regular user, you should read the Red documentation for the current stable release.

Cleanup

This is the cog guide for the cleanup cog. You will find detailed docs about usage and commands.

[p] is considered as your prefix.

Note

To use this cog, load it by typing this:

[p]load cleanup

Usage

This cog contains commands used for “cleaning up” (deleting) messages.

This is designed as a moderator tool and offers many convenient use cases. All cleanup commands only apply to the channel the command is executed in.

Messages older than two weeks cannot be mass deleted. This is a limitation of the API.

Commands

cleanup

Syntax

[p]cleanup

Description

Base command for deleting messages.

cleanup after

Note

This command is locked to the mod role.

Syntax

[p]cleanup after <message_id> [delete_pinned=False]

Description

Delete all messages after a specified message.

To get a message id, enable developer mode in Discord’s settings, ‘appearance’ tab. Then right click a message and copy its id.

Arguments:

  • <message_id> The id of the message to cleanup after. This message won’t be deleted.

  • <delete_pinned> Whether to delete pinned messages or not. Defaults to False

cleanup before

Note

This command is locked to the mod role.

Syntax

[p]cleanup before <message_id> <number> [delete_pinned=False]

Description

Deletes X messages before the specified message.

To get a message id, enable developer mode in Discord’s settings, ‘appearance’ tab. Then right click a message and copy its id.

Arguments:

  • <message_id> The id of the message to cleanup before. This message won’t be deleted.

  • <number> The max number of messages to cleanup. Must be a positive integer.

  • <delete_pinned> Whether to delete pinned messages or not. Defaults to False

cleanup between

Note

This command is locked to the mod role.

Syntax

[p]cleanup between <one> <two> [delete_pinned=False]

Description

Delete the messages between Message One and Message Two, providing the messages IDs.

The first message ID should be the older message and the second one the newer.

Example:
  • [p]cleanup between 123456789123456789 987654321987654321

Arguments:

  • <one> The id of the message to cleanup after. This message won’t be deleted.

  • <two> The id of the message to cleanup before. This message won’t be deleted.

  • <delete_pinned> Whether to delete pinned messages or not. Defaults to False

cleanup bot

Note

This command is locked to the mod role.

Syntax

[p]cleanup bot <number> [delete_pinned=False]

Description

Clean up command messages and messages from the bot in the current channel.

Can only cleanup custom commands and alias commands if those cogs are loaded.

Arguments:

  • <number> The max number of messages to cleanup. Must be a positive integer.

  • <delete_pinned> Whether to delete pinned messages or not. Defaults to False

cleanup messages

Note

This command is locked to the mod role.

Syntax

[p]cleanup messages <number> [delete_pinned=False]

Description

Delete the last X messages in the current channel.

Example:
  • [p]cleanup messages 26

Arguments:

  • <number> The max number of messages to cleanup. Must be a positive integer.

  • <delete_pinned> Whether to delete pinned messages or not. Defaults to False

cleanup self

Syntax

[p]cleanup self <number> [match_pattern] [delete_pinned=False]

Description

Clean up messages owned by the bot in the current channel.

By default, all messages are cleaned. If a second argument is specified, it is used for pattern matching - only messages containing the given text will be deleted.

Examples:
  • [p]cleanup self 6

  • [p]cleanup self 10 Pong

  • [p]cleanup self 7 "" True

Arguments:

  • <number> The max number of messages to cleanup. Must be a positive integer.

  • <match_pattern> The text that messages must contain to be deleted. Use “” to skip this.

  • <delete_pinned> Whether to delete pinned messages or not. Defaults to False

cleanup spam

Note

This command is locked to the mod role.

Syntax

[p]cleanup spam [number=50]

Description

Deletes duplicate messages in the channel from the last X messages and keeps only one copy.

Defaults to 50.

Arguments:

  • <number> The number of messages to check for duplicates. Must be a positive integer.

cleanup text

Note

This command is locked to the mod role.

Syntax

[p]cleanup text <text> <number> [delete_pinned=False]

Description

Delete the last X messages matching the specified text in the current channel.

Example:
  • [p]cleanup text "test" 5

Remember to use double quotes.

Arguments:

  • <number> The max number of messages to cleanup. Must be a positive integer.

  • <delete_pinned> Whether to delete pinned messages or not. Defaults to False

cleanup user

Note

This command is locked to the mod role.

Syntax

[p]cleanup user <user> <number> [delete_pinned=False]

Description

Delete the last X messages from a specified user in the current channel.

Examples:
  • [p]cleanup user @Twentysix 2

  • [p]cleanup user Red 6

Arguments:

  • <user> The user whose messages are to be cleaned up.

  • <number> The max number of messages to cleanup. Must be a positive integer.

  • <delete_pinned> Whether to delete pinned messages or not. Defaults to False

cleanupset

Note

This command is locked to the admin role.

Syntax

[p]cleanupset

Description

Manage the settings for the cleanup command.

cleanupset notify

Syntax

[p]cleanupset notify

Description

Toggle clean up notification settings.

When enabled, a message will be sent per cleanup, showing how many messages were deleted. This message will be deleted after 5 seconds.