This release improves data hygiene, gives admins faster follow-up actions after score updates, and strengthens reliability across setup and delivery flows.

Highlights:
- CleanerBot now runs a daily low-priority cleanup for stale member-scoped records, removing data only after Discord confirms the user has left the server.
- /set_decay_score now supports two optional follow-up actions after a score change: public inactivity warning and personal DM warning, each confirmable or skippable.
- DM follow-up is skipped automatically when inactivity DMs are disabled, and score/warning actions are logged in /config history.
- New server setups now include member-join tracking by default for stronger day-one inactivity coverage.
- Threshold behavior is now consistent between /start and /config, with unified ranges and strict validation order.
- Grace period handling is now more transparent, with no hidden catch-up score jumps after grace ends.
- Cleanup paths and delivery retries were hardened to reduce stale data and missed warning/welcome messages during transient API issues.

Release notes: https://cleanerbot.eu/changelog/v2-18-0/

CleanerBot v2.18.0 is live - Smarter Cleanup, Better Admin Follow-Ups

This release improves large member imports, smooths admin review handling, and fixes key reliability issues.

Highlights:
- /bulk_user_upload is now faster and safer for large imports, with stronger abuse protection, better rate-limit handling, live progress updates, and a one-click "Stop Upload" option.
- Background checks stay more reliable during busy Discord API periods.
- Permission diagnostics are cleaner, so setup issues are easier to identify and fix.
- Manual kick review now supports "Apply to All" when no members are selected, and accepts multiple recent review messages (up to 14 days old by default).
- /score_settings publish-channel selection appears reliably again.
- Stats syncing to discordservices.net now retries better after Cloudflare checks.
- Closed quiz polls now keep the original question visible together with the correct answer.

Release notes: https://cleanerbot.eu/changelog/v2-17-5/

CleanerBot v2.17.5 is live - Faster Bulk Uploads, Cleaner Admin Controls

This release adds a major onboarding improvement for large servers and expands optional safety controls for inactivity removals.

Highlights:
- /bulk_user_upload now supports CSV attachment uploads via file, while manual ids input remains fully backward-compatible.
- CSV imports auto-extract Discord IDs, deduplicate entries, process full files in internal batches, and provide clearer import reporting.
- Added optional pre-kick DMs with /config toggle dm_kick so members receive a friendly notice before inactivity removal.
- Added optional reinvite links for pre-kick DMs via /config set reinvite_url (manual review can include or skip per action; auto-kick includes when configured).
- Added a new /advises advisory covering optional kick setup paths: auto-kick, manual review, pre-kick DM, and reinvite URL.
- Added a bot-operator-managed safety blocklist; blocked servers are left silently on startup or join.
- /coverage and monthly staff coverage reminders now include direct guide CTAs for faster setup.
- Reliability upgrades include moving global maintenance jobs to a dedicated worker, cleaner champion ping formatting, and concurrent daily permission checks.

Bulk Upload Guide: https://cleanerbot.eu/features/bulk-upload/
Release notes: https://cleanerbot.eu/changelog/v2-17-4/

CleanerBot v2.17.4 is live: CSV Bulk Upload, Safer Kick Flow, Reliability Upgrades

This release adds new tools for managing kick exemptions, lets admins silence coverage reminders permanently, and delivers several reliability fixes across the bot.

Highlights:
- /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 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, and admins can lift it anytime with /tips_reset coverage_bulk_upload_staff_notice.
- CleanerBot now runs on Discord's AutoShardedBot foundation, improving resilience to gateway interruptions and preparing for horizontal scaling.
- Localization quality significantly improved across EN, DE, ES, FR, PT, and IT.
- Monthly streak champion announcements now correctly ping the winners.
- The manual kick review now always shows the member selection dropdown, and the "last active" date is now accurate.
- /leaderboard no longer crashes when results are too long; the file attachment fallback now displays correctly.

Release notes: https://cleanerbot.eu/changelog/v2-17-3/

CleanerBot v2.17.3 is live - Kick Exemption Management, Mutable Coverage Reminders, Reliability Fixes

This release adds a new admin command for instant member coverage checks, expands the config and help interfaces, and ships a solid round of reliability fixes.

Highlights:
- New /coverage command shows how many members CleanerBot is actively managing vs. the server's estimated total, with a low-coverage indicator and a prompt to run /bulk_user_upload if needed.
- /config show has a new "Analytics & Reporting" page with your AHS tracking status, public share setting, publish channel, and event auto-post toggle in one place.
- /help now has a "Jump to section" dropdown so you can go directly to any help page without stepping through them one by one.
- Staff coverage reminders now use a monthly cap and a 7-day grace period, and only nudge when the missing-member gap is meaningfully large, reducing false positives.
- Ethics statements have been refined for accuracy and clarity across all relevant commands.
- Several fixes for kick review dropdowns, /purge_channel error cards, /leaderboard and /report_inactivity resend flows, decay and reward announcements, "Why?" explainer cards, startup sequencing, shard stability, and /export_decay_data reliability.

Release notes: https://cleanerbot.eu/changelog/v2-17-2/

Thanks for trusting CleanerBot with your community!

CleanerBot v2.17.2 is live - Coverage Command, Smarter Config, Reliability Fixes

This release completes a full Components v2 rework across all user-facing bot messages and improves reliability for shard placement and reminder controls.

Highlights:
- 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.
- Restored advisory hero images in staff advisory cards and DM copies when attachment permissions are available.

Release notes: https://cleanerbot.eu/changelog/v2-17-1/

CleanerBot v2.17.1 is live - Full Components v2 Rework, Clearer Messaging

This release adds new admin controls and improves reliability across inactivity workflows, setup, routing, kick dedupe, and reward-role synchronization.

Highlights:
- Added /donate so members can open the optional Buy Me a Coffee link directly in Discord.
- Added /config toggle kick_announcements so admins can disable kicked-member summary announcements without muting other alerts.
- Added /reward reward_grace_dm so admins can pause pre-removal reward-role reminder DMs without disabling reward roles.
- Members using /mute now also suppress reward grace-ending DMs in that server, and /unmute re-enables them.
- /config show now falls back to a clickable root command mention when Discord has not cached a newer subcommand path yet.
- Highscore announcements now honor min_streak_notification inclusively, so a value like 14 triggers at streak 14.
- Setup wizard Set buttons now open their input dialog reliably instead of timing out intermittently.
- Automatic inactivity kicks now ignore duplicate retries within the same run window, preventing duplicate removals and duplicate notifications.
- Shard routing now blocks silent cross-shard fallbacks and auto-repairs missing guild-to-shard mappings, reducing guild-count drift.
- New guild joins now seed shard mappings before premium checks, preventing join-time routing errors.
- Rejoining members now start from a clean activity baseline, preventing stale counters from blocking reward-role sync.
- Expired Supporter roles are now removed before stale vote-state cleanup, keeping role expiry reliable while old cache rows are pruned.

Release notes: https://cleanerbot.eu/changelog/v2-17-0/


CleanerBot v2.17.0 is live - More Admin Controls, More Reliable Routing

This release improves safety and reliability in inactivity workflows, especially around manual kick reviews and report stability.

Highlights:
Inactivity tracking consistency is improved so score and grace-state updates stay aligned and false mismatch noise is reduced.
Manual kick review is safer because stale review actions are now blocked, preventing duplicate kicks from older review messages.
Botlist statistics now include estimated user totals on providers that support user-count fields.
Fixed a /report_inactivity issue where some report views failed to open when tip buttons were shown.
Fixed decay history retrieval so score history remains reliable without database fallback errors.

Release notes: https://cleanerbot.eu/changelog/v2-16-1/


CleanerBot v2.16.1 is live - Safer Kick Reviews, More Reliable Reports

This release makes inactivity reporting easier to review at scale and improves reliability when Discord has temporary API issues.

Highlights:
- /leaderboard now uses pagination (default 25 entries, optional page_size) and automatically falls back to TXT export when results exceed embed limits.
- /report_inactivity now supports optional page_size (default 25), and both report views resend only the currently viewed page to channels.
- Warning summaries and inactivity reminder DMs now retry during temporary Discord API outages, reducing missed alerts.
- Activity-decay data handling is now leaner and more stable over time, with no intended change to score outcomes.
- CleanerBot now syncs stats and slash commands to DiscordForge and can process DiscordForge vote webhooks for vote-linked features.

Release notes: https://cleanerbot.eu/changelog/v2-16-0/


CleanerBot v2.16.0 is live - Paginated Reports, Stronger Delivery Resilience

This release improves reliability during heavy API pressure, expands botlist vote support, and keeps inactivity reporting cleaner for admins.

Highlights:
Added /config set inactivity_role_mode with inactive_overlay so you can add and later remove only the inactivity role without changing members' other roles.
Decay scans now run with steadier sequential member checks, reducing long stalls during heavy Discord API rate-limit periods.
Vote and Vote Joker now support all configured botlists, and Answer Hint prompts include a direct Top.gg vote button for faster access.
Inactivity reminder DMs now auto-mute members per server after delivery failures, preventing repeated failed attempts.
Added DiscordThings as a new supported botlist.
Notification comment buttons now recover more reliably from thread-creation API errors by reusing an existing thread when one already exists.
Reaction-based activity handling now stays stable during temporary Discord DNS/network outages instead of crashing reaction-remove processing.
Reboot and shutdown now handle in-flight decay database work more gracefully, reducing noisy transient error logs while services are stopping.
Members who were auto-kicked are now removed from inactivity reports immediately, so /report_inactivity no longer shows stale kick candidates.

Release notes: https://cleanerbot.eu/changelog/v2-15-6/

CleanerBot v2.15.6 is live - More Reliable Decay Runs, Cleaner Inactivity Reporting

This release makes onboarding much easier for server admins and improves stability during heavy decay runs.

Highlights:
- Guided /start is now significantly shorter and lower-friction, with core decisions first and advanced options moved to /config.
- Setup flow is clearer: staff channel first, then thresholds, then optional role/channel decisions.
- Admin role and several role-heavy setup choices are now optional-by-design, so teams can complete setup faster.
- Auto-kick selection was removed from guided setup; CleanerBot now starts with manual review and staff-channel fallback where appropriate.
- First-run onboarding is cleaner: soft blockers are hidden initially and shown once the guild is active.
- Permission guidance is clearer: Manage Roles is treated as required only when role-based automation is actually configured.
- Decay-run resilience is improved for transient Discord API response issues, with safer skip behavior under pressure.

Release notes: https://cleanerbot.eu/changelog/v2-15-5/

Thanks for trusting CleanerBot with your community.

CleanerBot v2.15.5 is live - Faster Guided Setup, Safer Defaults

Server analytics commands for cohort retention reports.

analytics

Bulk-prefetch listed IDs to seed guild decay entries without privileged intents.

bulk_user_upload

Lists the latest CleanerBot changes and updates.

changelog

Displays the premium status, tier, and expiry for this guild.

checkpremium

cohorts

Guild configuration commands for CleanerBot.

config

Shows members with the highest or lowest decay scores.

decay_top10

Export tracked member activity data as a CSV file.

export_decay_data

Displays premium tiers and member limits.

guildtiers

Shows CleanerBot help, localized docs, and quick actions.

help

Shows the activity-streak leaderboard for this guild.

leaderboard

Highlight the previous month's activity champions.

monthly_champions

Mute inactivity reminders from CleanerBot for this server.

mute

Show the invoking member's decay score, streak, and tips.

my_score

Shows when CleanerBot will run the next decay cycle.

next_check

polls

Configure Fun Polls/Quizzes and launch instant polls.

polls_wizard

Explain premium tiers, benefits, and upgrade paths.

premium

Delete messages inside a selected channel, optionally keeping the oldest messages.

purge_channel

[Owner] Recompute activity streaks from decay history.

recompute_streaks

Generate an inactivity report for tracked members.

report_inactivity

Reset all decay scores for the current guild.

reset_all_decay_scores

[Owner] Resync all global slash commands across Discord.

resync_commands

reward

List members who currently hold activity reward roles.

reward_members

Configure activity reward roles via a guided wizard.

reward_roles_wizard

Manually scan recent history to backfill member activity.

scan_history

Show this server's Activity Health Score (7-day window).

score

Return the public Activity Health Score link when enabled.

score_link

Publish the latest Activity Health Score to a channel.

score_publish

Inspect or adjust Activity Health Score settings.

score_settings

set_decay_score

Launch the CleanerBot guided setup wizard.

start

Display CleanerBot's Terms of Service and Privacy Policy.

terms

Send a private Silent Kudos thank-you to another member.

thanks

[Owner] Reset the Silent Kudos cooldown between two members.

thanks_reset

Clear staff advisory tip frequency caps for this guild.

tips_reset

Re-enable inactivity reminders from CleanerBot for this server.

unmute

Show detailed decay and streak data for a specific member.

user_score

Automatically grant roles to users who achieve configured requirements

Automatic Roles

This bot offers extra features or perks that can be unlocked through optional payments or subscriptions.

Paid Features Available

Whether the current project contains any paid features, is paid only, or is 100% free to use.

This project is free to use and contains no paywalls for core functionality.

Has Paid Features

CleanerBot

Fair inactivity cleanup + event analytics. No message access, no privileged intents. Use /start

Voting for CleanerBot

Do you want to support us?