Explore

Advertise

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

CommandCleanup

CommandCleanup

3.57

0

Invite

Vote (32)

CommandCleanup does as it sounds.. and so much more!


CommandCleanup • Discord Shield Discord Bots Discord Bots

CommandCleanup is a bot that can delete a variety of different messages, wether it be messages that begin with the most common command symbols, messages by a certain user or messages sent by bots, there is a command/parameter that'll help clean up your chats regardless of what's posted.


Commands

cleanup

Pairing this command with parameters gives you MAXIMUM chat moderation control
requires permissions: MANAGE MESSAGES

invite

Get an invite link to add the bot to more servers

help

Sends helpful documentation about commands, their usages, their aliases and even a short description


Parameters

Parameters allow for 100% control over the content deleted, giving you complete chat moderation control.

Below is a list of all available parameters and what they do.. You can use multiple parameters in a single command, so mix and match to your liking.

Parameter Legend: (required) - <optional>
before (message id | message link | timeframe)

Targets messages posted before the specified message id, message link or timeframe.

after (message id | message link | timeframe)

Targets messages posted after the specified message id, message link or timeframe.

attachments <extensions>  aliases: files

Deletes messages with file attachments (not images)
Valid extensions are a fullstop followed by the extension, example: .mov

images <extensions>  aliases: imgs

Deletes messages with image attachments (not files)
Valid image extensions are webp, png, jpg, jpeg & gif

text <quotes>  aliases: txt, contains

Deletes messages with plain text (no embed, no images, no files, etc..)
If quotes are provided, then only messages containing the quotes will be targeted*
Valid quotes are any word/sentence enclosed in quotation marks, example "hello world"

commands <prefixes>  aliases: cmds, startsWith

Deletes messages that begin with the most common command symbols (-, !!, /bb, etc..)
If prefixes are provided, then only messages beginning with those prefixes will be targeted
Valid prefixes are any word/symbols enclosed in quotation marks, example "!play"

links <urls>

Deletes messages that contain links
If urls are provided, then only messages containing those links will be targeted

embeds

Deletes messages that contain embeds

bots

Targets messages sent by other bots

purge

Targets messages from users that no longer exist in the server (kicked, banned, left, etc..)

discord

Deletes discord system messages (welcome messages, pin added messages, etc..)

invites

Deletes discord invites

limit (number)  aliases: amount

Sets the maximum number of messages to be deleted
This parameter cannot be used by itself and must be paired with at least one other parameter from this list

all

Targets messages of any kind, excluding pinned

pinned

Deletes messages that are pinned

@mentions

Targets messages of the mentioned user or role
If a user has left the server but you still want to clean their messages without cleaning all other members who have left, copy their user id and type <@!id> (replacing id with the users id) as the response instead of a mention.


FAQs

What is a timeframe?

Timeframes are arguments only available to the before and after parameters. Timeframes are constructed by numbers followed by a letter/work representing the duration, example 1d equals 1 day.

Timeframes can also be stacked on top of each other for more complicated timeframes, example 1d 20h 10m 30s equals 1 day, 20 hours, 10 minutes and 30 seconds.

Discord bulk-delete limitation

Unfortunately this bot (like many others) cannot delete messages older than 14 days in mass amounts, this is due to the discord api limiting the bulk-delete endpoint to only delete messages that do not exceed 14 days old.


Most Common Issues

I'm using the purge command but it's not working..

This is a common misconception, purge is a parameter and should be added after the command cleanup. Example .cleanup purge

Won't delete messages older than 14 days?

We touched up on why this occurs earlier in the FAQs section, talking about discord bulk-delete limitations

I've added the bot to my server but it isn't working..

There could be many number of reasons, the most common though is incorrect permissions inside the channel. Best way to check is make sure the bots (and any of it's roles) aren't denied access to manage messages inside the guild or the channel. If errors persist then feel free to stop by the support server linked below

How do I get a discord id?

Here is a great support article talking about how to copy ids from users, roles, messages, guilds, etc..

Support Server

If you have any issues that aren't mentioned here, stop by our support server and see if we can help there

Discord Server Banner


Top Discord Servers Using This Bot


SXL Modding

PokéMeow Official Server

League of Legends: Wild Rift

Spacestation

Overtake - Romania

True RP: Los Angeles

MuratAbiGF

SalmaSMP

100 Twitch Emotes

Ratings & Reviews


3.57

35 reviews

Reviews can be left only by registered users. All reviews are moderated by Top.gg moderators. Please make sure to check our guidelines before posting.

5 stars

15

4 stars

7

3 stars

4

2 stars

1

1 star

8


Thor/Tushy
Thor/Tushy

almost 2 years ago

It ain’t working it only cleans 3 messages now

3


prydu
prydu

11 months ago

It does as perfectly as it sounds, and it is not that hard to work if you know about bots with a decent knowledge, and I believe this bot has great potential, and I've used it in all of my servers for about 6 months, and it's a great bot! I would recommend using this in the future and on your servers.

1


urmxmmy
urmxmmy

almost 2 years ago

the bot has been offline for a while and it's hard to find other bots that'll clean up chats other then that its a pretty good bot

1


Bransgoreboy208
Bransgoreboy208

almost 2 years ago

this is a good bot but i don't know how to use it

1


ᏒᎧᏰᏰᎩ
ᏒᎧᏰᏰᎩ

about 2 years ago

I would call it half because it just is rather helpfull but is tough to work

1


Banana soup
Banana soup

over 1 year ago

Ok what the thingy for it / or ! or ?

1


$W()R|)
$W()R|)

over 1 year ago

it does not say the prefix

0


LongSchlongSilver
LongSchlongSilver

over 1 year ago

I'm trying to purge messages from someone who got banned, and it won't take his @ as a valid parameter (.cleanup purge @username#0000 is an example of what I said btw).

0


indigo
indigo

over 1 year ago

eyyy nice

0


Splitze0
Splitze0

over 1 year ago

Awesome Bot. Works just as intended too.

0



Details

Prefix

.cleanup

Shards

40

Socials

Discord Support Server

GitHub

Tags

    Moderation

    Utility