DiscordCleanerBot is the essential tool for server owners and moderators looking to efficiently manage member activity, maintain a vibrant community, and ensure your server thrives.This intelligent bot automates the process of identifying, reporting on, reminding, and ultimately kicking inactive users, freeing up your time and keeping your member list fresh. It's designed to promote engagement and streamline server administration by gently nudging inactive members or, when necessary, automatically removing them.Clean up your server. Boost engagement. Automate moderation.

β€œThe best bot for keeping our server clean. It just works.”
β€” Cobra, 20+ member gaming community

πŸ’° Freemium vs. Premium

Core Benefits

  • Set It & Forget It:Β Automate inactivity checks, role assignments, and member kicking.

  • Stay in Control: Full manual commands for advanced control and insights.

  • Increase Engagement: Gently nudge inactive users to return and participate.

  • Cleaner Communities: Remove ghost members and improve member-to-engagement ratio.

  • Configurable & Scalable: Works for small hobbyist groups and massive Discord communities.

FeatureAll tiers
Manual inactivity reportπŸ‘πŸ»
Fully automatic daily inactivity checksπŸ‘πŸ»
Auto role assignment + strippingπŸ‘πŸ»
Auto kicking after thresholdπŸ‘πŸ»
Custom inactivity thresholdsπŸ‘πŸ»
Whitelisting of channels (no activity scan)πŸ‘πŸ»
Export activity reportπŸ‘πŸ»
Multi-language supportπŸ‘πŸ»

Pricing

  • freemium :Β free (up to 100 guild members)

  • pro : $ 1.99 / month (up to 1,000 guild members)

  • scale : $ 3.99 / month (1,000+ guild members)

πŸ™‹πŸ» Frequently Asked Questions (FAQ)

Getting Started

  1. Go to https://discord.com/oauth2/authorize?client_id=1368223375364980746.

  2. Click "Invite" and select your server.

  3. Review and grant required permissions: Manage Roles, Kick Members, View Channels, Read Messages, Read Message History, Send Messages.

Set Bot Role Hierarchy

  1. In your Discord server, navigate to Server Settings -> Roles.

  2. Find the role named after your bot (e.g., "CleanerBot").

  3. Drag this role to a high position in the list, ideally just below your Administrator/Moderator roles. It must be above any roles it needs to manage (assign/strip) or members it might kick.

  4. Confirm its permissions include Manage Roles, Kick Members, View Channels, Read Messages, Read Message History, and Send Messages.

  5. Save Changes.

Configure Core Inactivity Settings

  1. Use the /config command or specific slash commands to tailor CleanerBot to your server. This is your main command to view and change most settings.

  2. Start with /config set_admin_role, the bot will guide you through the setup.

  3. To setup an inactivity threshold, where users receive an @inactive role, e.g., after 30 days, use /config set_inactivity_threshold days:30. Set a kick threshold of additional 30 days, use /config set_kick_threshold days:30, so that users are mentioned and receive a warning to the channel you've specified via /config set_warning_channel channel:xxx after being inactive since 30 days and automatically being kicked after overall 60 inactive days (another message is sent to that channel, informing about the kick due to inactivity). This will additional support engagement of other members, warning them about the auto-kick-feature, if not being active. It's simple as that. πŸš€

  4. Validate and, if complete, finalize the configuration with /config validate. View your configuration via /config show at every time.

  5. Go through optional settings, like whitelisting channels the bot should not search nor watch for member's activities with /config add_whitelisted_channel or exclude roles from activity screening, e.g., admin roles, with /config add_exempt_role.

Run Your First Report

See your current inactive members before the bot starts its autonomous work 24h after initial setup, by typing /reportinactivity.

Other Useful Commands

  • /about: Learn more about CleanerBot, its features, and support.

  • /premium: Learn about CleanerBot's premium features and how to unlock them!

  • /help: Get help with CleanerBot or report an issue.

  • /checkpremium: Check the current premium status for your guild.

  • /lastactive: Shows the last known activity and join date for a member.

  • /exportactivity: Exports the activity cache as a CSV file.

  • /next_check: Shows the next scheduled run of the automatic inactivity check.

  • /guildtiers: View the member limits for each tier.

  • /reset_guild_activity_cache: Resets the activity cache for the guild. Use with caution.

  • /list_commands: Lists all available slash commands for this bot.

🫢🏻 Showcase : some real-life impressions

Some of the messages shown, like the inactivity warnings or kick notifications, are examples of what a guild member would typically see. These are standard, individualized communications from the bot to your members.