CleanerBot

Changelog

Latest updates, features, and improvements straight from the bot's feed.

v3.7.0
New Improvements

Personal notifications and quieter announcements

  • Members can now use /notifications to manage personal CleanerBot DM reminders for each server.
  • Inactive-role and reward-role announcements now show plain role names instead of Discord role mentions, so role references stay quiet.
  • Yearly anniversary summaries now use clearer community impact wording around fair cleanup, engagement wins, privacy, and Activity Health Score readiness.
v3.6.0
New Improvements Fixes

Auto-Kick compatibility limits and weekly leaderboards

  • Admins can now lower Auto-Kick throughput per run, UTC hour, and UTC day with /config set auto_kick_daily_limit.
  • CleanerBot can now post the current activity streak leaderboard to the warning channel every Monday.
  • Bulk uploads, manual kick reviews, kick summaries, purge controls, and announcement diagnostics are clearer and more resilient.
v3.5.0
New Improvements Fixes

Why button control and cleaner reviews

  • Admins can now choose whether new announcement posts include Why? explainer buttons with /config toggle why_buttons.
  • /review impact, monthly Staff Reviews, and DiscordThings vote handling now give admins clearer follow-up paths and broader vote support.
  • Fixes improve exempt-role reporting, /score threshold checks, manual kick confirmations, and reliability during temporary Discord or database interruptions.
v3.4.0
New Improvements Fixes

Amnesty windows and steadier bulk uploads

  • Admins can now set a seasonal decay amnesty window with /config set amnesty_window.
  • Long /bulk_user_upload CSV runs now keep progress and final results on one persistent channel message.
v3.3.0
New Improvements Fixes

Full Review packs and quieter Ghost mode controls

  • /bulk_user_upload now asks whether to apply configured restore/swap roles to newly seeded members during roster setup.
  • /config toggle ghost_member_posts lets Ghost mode servers suppress member-related announcement posts while cleanup, reports, and support keep running.
  • Free servers below the tracked-member limit can now use one-time Full Review packs to unlock automatic monthly Staff Reviews without the need to subscribe.
v3.2.0
New Improvements Fixes

Review History and Safer Cleanup Tools

  • /review history adds rolling Premium Staff Review history for saved and staff-posted reviews.
  • /purge_channel can now target one selected member or a departed user's Discord ID.
  • Review cards now provide clearer trend context, guidance, Premium plan links, and over-limit recovery signals.
v3.1.0
New Improvements Fixes

Premium Staff Reviews

  • /review is the new Premium Staff Reviews home for cleanup, coverage, channel, retention, and engagement reports.
  • Existing /summary, /cohorts, and /analytics cohort_report report paths now point staff to the matching /review report.
  • Whitelisted categories now correctly exclude their channels from setup readiness checks, permission warnings, activity scans, and report paths.
v3.0.1
Improvements Fixes

Clearer Status and Safer Admin Flows

  • /ping, the website status page, and the support community status panel now show Discord API issues separately from CleanerBot issues. This makes it easier to tell when slow or failed responses are caused by Discord itself rather than your server setup or CleanerBot.
  • Free servers that are still within the Free tracked-member limit may now see an optional Buy Me a Coffee button in /summary results and monthly staff summaries. This is only a voluntary support option and does not change how CleanerBot works. Pro, Scale, and over-limit Free servers keep their existing action-focused controls without this extra button.
  • /summary impact and monthly staff summaries now give staff clearer next steps by pointing to /score and cohort reports. When enough activity data is available, they also highlight the most active channels so admins can quickly see where the community is still alive.
v3.0.0
New Improvements Fixes

Safer Starts and Clearer Community Insight

  • Admins can now use /summary cleanup and /summary impact to review cleanup outcomes, engagement signals, and Activity Health Score trends by month, year to date, or since CleanerBot started collecting summary data.
  • CleanerBot can now post automatic monthly summaries to the staff channel when setup is complete and a staff channel is configured. Admins can turn this off with /config toggle monthly_summary.
  • CleanerBot now creates yearly server anniversary summaries, giving staff a concise long-term view of cleanup activity, engagement trends, and Activity Health Score changes since setup.
v2.20.0
New Improvements Fixes

Recovery Milestones and Cleaner Admin Reviews

  • Admins can now use /config add kick_exemption to protect one member from inactivity kicks before a manual review decision is needed.
  • CleanerBot now recognizes members who recover after an inactivity warning. They receive a short welcome-back DM, and the server gets a positive announcement in the same channel and visibility as their original warning, so no new noise is created.
  • Members can now be celebrated when they set a new personal activity streak best, including after a quiet period. Personal milestone announcements follow the same visibility settings as other streak updates.
v2.19.2
New Improvements Fixes

Feedback Collection and Reliability Hardening

  • Added /feedback for all server members, with category selection and an optional comment so teams can share structured feedback quickly.
  • Setup and completion DMs now include a "Give Feedback" button, making it easier for admins to send feedback during onboarding.
  • /scan_history is now available to all admins on all plans.
v2.19.1
Improvements Fixes

Ghost Mode Setup Recovery and Reminder Reliability

  • Admins can now run /config remove inactive_role in Ghost mode to remove a stale inactive role from the config. CleanerBot then resets to the default behavior (no inactive role assigned).
  • Ghost mode setup validation no longer prevents your setup from being considered complete when the configured inactive role no longer exists. The setup status stays consistent, and a clear /config validate message guides you through cleanup or reconfiguration.
  • DM inactivity reminders are now delivered reliably regardless of server size or infrastructure setup.
v2.19.0
New Improvements Fixes

New Commands, Resilient Infrastructure & Stability Fixes

  • New /invite command lets anyone add CleanerBot to another server (opens Discord's native add dialog directly), join the support community, or visit the website - all from one convenient card.
  • New /ping command shows a live status panel with aggregate status, component health, uptime, latency, guild count, and user count - the same view as the CleanerBot status channel.
  • New /config share command lets admins generate a share-safe CleanerBot setup summary with AHS settings and public link, preview it privately, post it in-channel, and copy it via attached Markdown export.
v2.18.0
New Improvements

Smarter Cleanup, Better Admin Follow-Ups

  • CleanerBot now runs a daily low-priority member-data cleanup that removes stale member-scoped records only after Discord confirms the user has left the server.
  • /set_decay_score now offers two optional follow-up actions after a score update: send a public inactivity warning in the configured warning channel and send a personal inactivity warning DM to the member. Admins can confirm or skip each action independently, the DM step is skipped automatically when inactivity DMs are disabled, and all actions are logged in /config history with the acting admin.
  • Added additional internal security hardening to improve protection against abuse and unauthorized access.
v2.17.5
Improvements Fixes

Faster Bulk Uploads, Cleaner Admin Controls

  • /bulk_user_upload is now faster and safer for large imports, with better abuse protection, smoother rate-limit handling, live channel progress updates, and a one-click "Stop Upload" option for admins.
  • Background checks now stay more reliable during busy periods with high Discord API traffic.
  • Permission diagnostics are now cleaner, so admins can spot and fix setup issues faster.
v2.17.4
New Improvements

CSV Bulk Upload, Safer Kick Flow, Reliability Upgrades

  • /bulk_user_upload now accepts CSV attachments via file as a preferred import path for large member exports, while keeping manual ids input unchanged.
  • CSV uploads automatically extract Discord user IDs, deduplicate entries, and process full files in internal batches without the 250-IDs-per-command cap used by manual input.
  • Admins can now enable a pre-kick DM (/config toggle dm_kick) that sends members a short, friendly notice before they are removed for inactivity, explaining it is not a ban and they are welcome to rejoin.
v2.17.3
New Improvements Fixes

Kick Exemption Management, Mutable Coverage Reminders, Reliability Fixes

  • /config list kick_exemptions opens a paginated list of all kick-exempt members, with a built-in removal menu for quick management.
  • /config remove kick_exemption <user> removes a member's exemption and resets their decay score and activity streak to zero, returning them cleanly to the normal activity cycle.
  • Staff coverage notices now have a "Mute this notice" button. Clicking it stops the monthly reminder permanently for your server - the mute status is visible in /config show under General Settings, and admins can lift it anytime with /tips_reset coverage_bulk_upload_staff_notice.
v2.17.2
New Improvements Fixes

Coverage Command, Smarter Config, Reliability Fixes

  • /coverage lets admins instantly check how many members CleanerBot is actively managing compared to the server's estimated total, with a clear indicator when coverage is below 85% and a hint to run /bulk_user_upload if needed.
  • /config show now includes an "Analytics & Reporting" page showing your AHS tracking status, public share setting, publish channel, and event auto-post toggle - all in one place.
  • /help now has a "Jump to section" dropdown, matching the navigation already available in /config show, so you can jump directly to any help page without stepping through them one by one.
v2.17.1
New Improvements Fixes

Full Components v2 Rework, Clearer Messaging

  • Completed a full Discord Components v2 rework across all user-facing messages so commands, DMs, setup flows, announcements, polls, and admin responses now share one consistent card-style layout with clearer guidance and actions.
  • Improved new-server shard assignment so CleanerBot now prefers stable, lower-load database shards using both guild volume and data-volume signals, with hard caps that prevent overloaded placement.
  • Reward grace reminder DMs now include the same Mute this server and Why? controls as warning and inactive reminder DMs.
v2.17.0
New Improvements Fixes

More Admin Controls, More Reliable Routing

  • Added /donate so members can open an optional Buy Me a Coffee link directly in Discord to support the project.
  • Added /config toggle kick_announcements so admins can silence kicked-member summary announcements without muting other alerts.
  • Added /reward reward_grace_dm, a dedicated reward setting for pre-removal reward-role DMs, so admins can pause those reminders without disabling reward roles.