Premium Staff Reviews

• /review is the new Premium Staff Reviews home for turning CleanerBot's activity, cleanup, coverage, and channel-health signals into staff-ready review cards.
• /review impact gives admins a monthly or custom-period overview of warnings, recoveries, removals, engagement signals, coverage context, and one recommended next action.
• /review cleanup focuses on the cleanup funnel: warnings, inactive roles, recoveries, manual review workload, removals, current policy context, and fairness notes.
• /review channels reviews quiet channels with confidence notes, helping staff decide whether to archive, merge, promote, or intentionally keep them.
• /review coverage explains whether CleanerBot has enough tracked-member and channel-visibility coverage to support reliable staff decisions.
• /review retention summarizes recent retention among members known to CleanerBot, without requiring privileged member-list access.
• /review engagement summarizes short-window engagement reach, activity mix, week-over-week changes, confidence caveats, and a suggested staff action.
• Existing report commands are moving into the new Staff Review flow. /summary cleanup, /summary impact, /cohorts summary, /cohorts compare, /cohorts channels, /cohorts dead-channels, and /analytics cohort_report now show migration cards that point staff to the matching /review report instead of showing the old report layout.
• Monthly reporting now uses the same Staff Review layer. Free servers receive useful preview cards, while Premium servers receive full Staff Reviews when the existing monthly report toggles are enabled.
• Coming later: saved review history, cleaner month-to-month comparisons, monthly channel rollups, engagement rollups, coverage snapshots, and a corresponding cleanup policy.

Improvements

• /premium now explains the main Premium benefits more clearly: Premium Staff Reviews with /review, full monthly review cards, higher tracked-member limits, and CSV exports.
• /premium now also clarifies that Bulk Upload is available outside Premium, so admins do not mistake it for a paid-only feature.

Fixes

• /set_decay_score now rejects bot accounts, preventing admins from accidentally seeding, scoring, or warning another bot.
• Whitelisted categories now correctly exclude their channels from setup readiness checks, permission warnings, activity scans, and report paths.

• /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.
• Exempt members now get clearer streak context in /my_score and /user_score. Instead of showing inactive calendar dots that could look like a problem, CleanerBot now explains their exempt status more accurately. Member score diagnostics also use localized full timestamps for easier review.
• /help now lists /cohorts dead-channels under the Activity Health Score report section, making the dead-channel report easier to find.
• /help now uses the same optional support-button style as /premium, /donate, and /summary, so support links feel consistent across CleanerBot.
• /purge_channel now prevents two purge jobs from running on the same channel at the same time. Deletes are also spaced out more safely, which helps reduce Discord delete-rate-limit spikes without slowing down unrelated CleanerBot features.

Fixes

• Fixed buttons in direct messages, including Why? and Mute this server, so members can use them from inactivity and reward grace reminders without interaction errors.
• Fixed impact summaries so they show that the Activity Health Score needs more data instead of showing a misleading score of zero.
• Fixed /config show so Auto-Kick mode is labeled correctly when automatic removals are active.
• Fixed personal-best streak posts so the same member no longer receives the same best-streak celebration twice from adjacent decay runs.
• Fixed dead-channel cohort reports so they continue to exclude both whitelisted channels and channels inside whitelisted categories.

Summary Reporting

• 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.
• Staff Advisories now include a Summary Reporting track, helping admins turn /summary cleanup and /summary impact into a simple monthly review routine.

Coverage Bootstrap

• /bulk_user_upload is now available on Free, Pro, and Scale so admins can seed known members by Discord user IDs or CSV and make coverage reports useful sooner.
• Bulk Upload now shows a localized preflight confirmation before imports start, including tracked-member counts, valid IDs found, tier context, and expected automation status.
• Free servers now receive a clear warning before an upload may push them above the 200 tracked-member limit. If that happens, CleanerBot pauses server automations until Pro or Scale is active, while reports and manual review may still be available.
• Bulk Upload final summaries now include an over-limit note when a Free server finishes above the tracked-member limit.
• The Bulk Upload staff advisory now explains tier availability, CSV coverage seeding, preflight limits, summary counts, and privacy handling more clearly.

• /my_score now includes a 14-day active/quiet calendar so members can understand their recent activity pattern without exposing message content.
• Activity Health Score cards now explain the current Excellent, Good, Fair, or Poor category in plain language.
• /config show now starts with a compact Safety Summary and Tracking Coverage guide covering auto-kick state, inactive role mode, key guardrails, a labeled website link, and next steps for /coverage, /user_score, and bulk seeding.
• The setup-complete DM now explains CleanerBot's careful start state: tracking begins from now, old join dates are not treated as guessed inactivity, coverage grows over time or through seeding, and Auto Kick state is shown plainly.

Improvements

• /start now uses Inactive Role Overlay as the safer default role mode. CleanerBot marks inactive members by adding the inactive role without changing their other roles, unless admins choose a swap mode.
• Ghost Mode is now clearer as the safest quick-start option: staff-only tracking, no public warnings, no member CTAs, and auto-kick disabled by default.
• /user_score and /my_score now explain why a member can still have Score 0, including decay timing, recent tracking refreshes, exemptions, and decay boost roles.
• Role-mode wording is clearer across setup and config screens, especially around which roles are added, removed, swapped, or restored. The existing /config add default_role command is still available.
• When a server is over its plan limit, premium notices now show exactly which automations and premium tools are paused, with clearer upgrade guidance and roster coverage context when available.
• Announcement cards are shorter and easier to scan. Ethics details now appear in the ephemeral Why? explanation, and staff-only Ghost Mode routing is shown with compact badges.
• During large member checks, CleanerBot now follows Discord retry timing more carefully, reducing rate-limit pressure during busy scans.
• Privacy-first ethics notes now appear more often, especially the promises that CleanerBot does not read message content, does not use ads or trackers, and does not build cross-server member reputations.
• Warning reminders now include a direct "how it works" walkthrough link for members who want more context before reacting to an inactivity warning.

Fixes

• Fixed /bulk_user_upload CSV imports so wide role-matrix exports with many role columns are accepted when a valid Discord user ID column is present.
• Fixed manual kick review confirmations so the "Apply to all" prompt closes after staff confirm or cancel, preventing accidental repeat clicks.
• Fixed personal streak celebrations so members are not celebrated twice for the same achieved streak.
• Fixed the final /start setup summary so follow-up actions use clickable commands instead of short-lived command buttons.
• Fixed Answer Hint button responses so expired Discord interactions no longer show an unnecessary failure after the action was already handled.
• Fixed Activity Health Score guardrail wording so admins can clearly see that both minimum active-member coverage and minimum activity-event volume must be met.
• Fixed /config validate output so informational permission notes use the correct localized heading.

• 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.

Improvements

• Copy across setup, decay score summaries, reminders, and Silent Kudos responses has been revised to be less technical and more welcoming, reducing confusion for first-time admins and members unfamiliar with decay scoring.
• Score, changelog, feedback, and inactive-role notifications now include clearer next steps without making buttons or reminders feel crowded.
• Monthly champion announcements now distinguish between first-time and returning champions with adapted copy, making the recognition feel less repetitive for active servers.
• Manual kick review lists now show clickable member profiles without pinging those members, making staff review faster and quieter.
• Free servers that exceed their tracked-member limit now run lighter daily decay checks. Full tracking continues, while processing load is reduced to keep the bot responsive for in-limit servers.
• CleanerBot now detects servers that have been unreachable on Discord for more than 24 hours and may leave them as part of its normal stale-server cleanup process. Healthy servers are not affected.
• Vote prompts now use clearer support cards with short buttons, so admins see why a vote helps without crowded button text.
• Large inactivity scans now pace live member lookups more consistently, reducing Discord rate-limit bursts during busy checks.
• Notification thread cleanup now scans archived threads more gently, helping scheduled cleanup stay reliable without pressuring Discord limits.

Fixes

• Fixed a Setup Wizard issue where long translated modal texts could fail to open on Discord. Inputs are now safely bounded so the wizard continues reliably.
• Fixed Poll activation feedback in Ghost Mode: CleanerBot no longer confirms polls as enabled when Ghost Mode keeps them off, and the Poll Wizard now shows a clear mode hint.
• Fixed an issue where one of a fun poll's emoji options could not be selected reliably due to an incorrect icon reference.
• Fixed /set_decay_score so a stale Discord interaction token no longer turns a completed score update into an error.
• Fixed notification comment cleanup so expired comment buttons on newer Discord message layouts can be disabled correctly.
• Fixed a rare inactivity score conflict where newer member activity could be shown while an older score snapshot stayed in place, ensuring decay scores always reflect the most recent state.

• 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.

Improvements

• /scan_history is now available to all admins on all plans.
• Configuration changes now always enforce valid warning, inactive, and kick threshold ordering, helping prevent invalid setups.
• Cleaner inactive_only guidance in /config and setup now clarifies that non-default roles are removed and not auto-restored in this mode.
• Member lookup handling is now more reliable during high activity and Discord API rate limits, reducing missed updates in large servers.
• Activity Health Score publishing now handles load pressure more reliably, reducing stalled or incomplete publish runs.
• Startup and reconnect handling is now more stable, reducing sporadic command errors and duplicate cleanup side effects.
• Webhook validation is now stricter, so misconfigured webhook integrations are safely rejected.

Fixes

• Fixed an issue that could incorrectly clear Pro and Scale entitlement records during cache maintenance and temporarily disable premium features.
• Fixed an edge case where Apply to all in manual kick review could fail to open the snooze modal.
• Fixed manual kick review handling for members who already left the server, so they are cleaned up instead of remaining stuck in review state.
• Fixed intermittent message update failures in wizard, admin progress, polls, /report_inactivity, and AHS status flows.

• 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).

Fixes

• 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.
• Setup health reminders (staff-only notifications about gaps in member coverage) now always stay in staff-only delivery paths and no longer fall back to public warning channels.
• Fixed an issue that could make setup information appear incomplete for a server after scaling changes. We contacted the affected server directly and restored everything there. At this time, no other servers are affected.

• 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.

Improvements

• Bulk upload guidance now reflects current behavior: CSV is the recommended path for large imports, strict single-input mode is enforced (ids or file, not both), manual ids input is capped at 250 unique IDs, and Stop Upload handling is clearly documented.
• Risk-review notices after threshold and decay-related config changes now explain impact more clearly, including that the change is saved and should be reviewed before high-impact automation is enabled or confirmed.
• Member-targeted announcement cards now include a plain-text affected-member list in code formatting, so members can still identify users when Discord mentions render inconsistently.
• Manual kick review confirmations now use clearer action wording and disable action buttons immediately after click, so admins get instant feedback while larger kick batches are processing.
• When CleanerBot leaves a server due to incomplete setup, the goodbye notice is now sent directly to the configured admin as a DM and includes a one-click re-invite button to easily bring the bot back.
• Server connections to Discord are now redundant. If one connection drops, only a small fraction of servers is temporarily affected instead of all at once.
• Internal maintenance tasks now run separately from command handling, so the bot stays fully responsive even during background operations.
• Server data is now stored across independent, isolated infrastructure segments. An issue or maintenance window in one segment no longer affects other servers, and new servers are assigned automatically.

Fixes

• Fixed a crash in /score_settings that prevented the channel selection picker from loading correctly.
• Voting on any connected botlist now correctly grants the supporter role and records the vote credit; previously only top.gg votes triggered the supporter flow.
• /set_decay_score now accepts the full 0-180 range, so manual corrections can match the same inactivity threshold ceiling used across setup and config.

• 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.

Improvements

• Added additional internal security hardening to improve protection against abuse and unauthorized access.
• New server setups now track member joins by default, improving inactivity coverage from day one.
• Threshold setup is now fully consistent between /start and /config: warning and inactive ranges are 1-180, kick range is 21-180, and validation enforces warning < inactive < kick.
• Grace periods now end cleanly without hidden catch-up score jumps; decay resumes from the grace boundary on the next regular interval.
• Leave cleanup is now centralized across inactivity data, vote intents, DM queue, DM mutes, advisory DM opt-ins, tip ledgers, silent kudos rows, and member-scoped AHS history.
• Member leave handling now keeps cleanup running even if one cleanup path fails, reducing stale inactivity data.
• Missing warning-channel permission alerts are now grouped and rate-limited per server, reducing repeated staff alert spam.
• Decay member fetches now retry transient API and network failures with backoff and include compact per-server health summaries.
• Bot-list stats updates now respect provider update windows and use safer retry and fallback behavior during API limits or temporary endpoint issues.
• Welcome DMs now retry transient Discord API failures (including 429 and 5xx responses such as 503), reducing missed welcomes during short outages.

• /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.
• In manual kick review, if no members are selected, admins now get a direct "Apply to All" confirmation for Kick, Exempt, and Snooze actions.
• Manual kick review now accepts multiple recent review messages at once (up to 14 days old by default), not just the newest one.

Fixes

• In /score_settings, the publish-channel picker now appears reliably again, so admins can choose the AHS publish channel directly in settings.
• Stats syncing to discordservices.net now retries more reliably after Cloudflare checks, reducing missed bot-list updates.
• Closed quiz polls now keep the original question visible and show the question plus the correct answer in one clear result block.

• /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.
• Add a reinvite link to pre-kick DMs with /config set reinvite_url (valid Discord invite URL required). During manual kick review, admins choose per action whether to include or skip the link. In auto-kick mode, the link is always included when configured.
• New advisory in /advises covering all optional kick settings: auto-kick, manual kick review, pre-kick DMs, and reinvite URL configuration.
• CleanerBot now maintains a bot-operator-managed blocklist: servers on it are left silently at startup and on any future join attempt, with no message to the server. This protects existing communities from sharing the bot with harmful servers.

Improvements

• Result reporting for CSV mode now adds import-specific visibility (total IDs found, duplicates skipped, processed) alongside existing added/known/not found/invalid/error outcomes.
• /coverage now includes a direct CTA button to the bulk upload guide whenever coverage is low or no estimate is available, so admins can act immediately.
• Monthly staff coverage reminders now include a direct guide button and updated copy for plan-specific next steps around CSV-assisted seeding.
• Coverage and setup guidance now consistently point admins to the bulk upload walkthrough: https://cleanerbot.eu/features/bulk-upload/.
• Internal reliability improvement: CleanerBot now offloads global maintenance jobs (decay history pruning, Vote Joker cleanup) to a dedicated worker process, reducing load on the bot and ensuring each job runs exactly once even if multiple instances are active.
• Monthly champion winner pings now follow the same format as other activity announcements: mentions are sent separately so the announcement card stays clean even for long tie lists.
• The daily channel permission check now runs across servers concurrently instead of one by one, cutting total run time significantly. Auto-fix attempts per server are capped to keep the check window predictable, with any remaining channels picked up on the next daily run.

• /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.

Improvements

• 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.
• CleanerBot now runs on Discord's AutoShardedBot foundation, improving resilience to gateway interruptions and preparing for horizontal scaling as your community grows.
• Localization quality significantly improved across EN, DE, ES, FR, PT, and IT.

Fixes

• 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 - showing the join date as a fallback for members with no recorded activity.
• /leaderboard no longer crashes when results are too long to fit in a message; the file attachment fallback now displays correctly.
• A false infrastructure alert that could fire when a server removed the bot mid-setup has been resolved.

• /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.

Improvements

• /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.
• Staff coverage reminders now use a monthly cap, wait for an initial 7-day grace period, and for non-tiny servers only nudge when the missing-member gap is above 20, reducing false positives.
• /report_inactivity now renders the ethics statement in its own separate card, so report content and policy guidance stay clearly separated.
• /export_decay_data now handles member lookup rate limits with capped retries and backoff, so exports recover faster instead of stalling on repeated rate limit responses.
• Refined ethics statements for accuracy and clarity, better reflecting CleanerBot's current features, data handling, and fairness principles.

Fixes

• Manual kick review cards now always include the member selection dropdown, so staff can select members before using kick, snooze, or exempt actions.
• /purge_channel now shows self-check and missing-permission errors in valid interaction cards again, preventing Discord payload errors during command use.
• /leaderboard and /report_inactivity resend flows now close old ephemeral cards safely, return proper in-app error cards, and avoid internal "check logs" wording in user-facing errors.
• Decay summary and reward-role announcements now post reliably again by avoiding a message payload combination that Discord rejects.
• "Why?" explainer cards now open reliably without Discord component payload errors.
• Startup now finishes cleanup and warmup housekeeping before queued inactivity DM work begins, preventing premature setup checks right after reboot.
• Startup now opens the housekeeping gate before leaderboard cache preloading completes, so delayed care loops can begin on time while leaderboard warmup continues in the background.
• Rapid leave/rejoin cycles now keep shard mappings stable and treat temporary missing-map states as soft skips in startup and license warmups, reducing noisy startup errors.
• Setup validation now names missing Manage Roles as the explicit blocker for role-based automation instead of saving an unclear unknown reason.
• /export_decay_data no longer crashes with a Discord payload error when a CTA card is shown alongside the export file.

• 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.

Improvements

• 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.

Fixes

• Restored advisory hero images in staff advisory cards and DM copies when attachment permissions are available.

• 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.

Improvements

• Members who use /mute now also mute reward grace-ending DMs in that server, and /unmute restores them.
• /config show now falls back to a clickable root command mention when Discord has not yet cached a newer subcommand path.

Fixes

• 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 dialogs reliably instead of occasionally timing out.
• Automatic inactivity kicks now ignore duplicate retries in the same run window, preventing duplicate removals and duplicate notifications.
• Shard routing now blocks silent cross-shard fallbacks and auto-repairs missing guild-shard mappings, reducing guild-count drift in status views.
• New guild joins now seed shard mappings before premium checks, preventing join-time routing errors.
• Members who rejoin after kick or leave now start with 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.

• Improved inactivity tracking consistency so score and grace-state updates stay aligned and false mismatch noise is reduced.
• Improved manual kick review safety by blocking stale review actions, which prevents duplicate kicks from older review messages.
• Bot list statistics now include estimated user totals on providers that support user-count fields.

Fixes

• Fixed a /report_inactivity issue where some report views failed to open when tip buttons were shown.
• Fixed decay history retrieval so score history stays reliable without database fallback errors.

• /leaderboard now uses paginated pages (default 25 entries, optional page_size) and automatically falls back to a TXT export when very large results would exceed Discord embed limits.
• /report_inactivity now also accepts an optional page_size (default 25), and both /report_inactivity and /leaderboard resend only the currently viewed page to channels.
• CleanerBot now retries warning summaries and DM deliveries during temporary Discord API outages, reducing missed inactivity alerts.
• Activity-decay data handling is now leaner and more stable over time, with no intended change to decay score outcomes.
• CleanerBot now syncs stats and slash commands to DiscordForge, and can process DiscordForge vote webhooks for vote-linked features.

• 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 (for example blocked bot or closed DMs), 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.

Fixes

• 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.

• Guided /start is now much shorter and lower-friction, focusing on essential choices first and moving advanced options to /config.
• Setup order is clearer: staff channel first, then thresholds, then optional role/channel choices based on mode.
• The admin role and selected role-heavy steps are now optional-by-design, so teams can finish onboarding faster.
• Auto-kick selection was removed from guided setup; CleanerBot now starts with manual review flow and staff-channel fallback where appropriate.
• First-run onboarding is cleaner: soft blockers are hidden at initial entry and shown once a guild is active.
• Poll and reward-role pro tips are delayed for the first week after onboarding to reduce early setup noise.
• Permission guidance is clearer: Manage Roles is only required when role-based automation is actually configured.

Fixes

• Decay runs now handle transient Discord API response issues more safely, skipping affected cases instead of failing whole runs.
• Phase-2 member-fetch behavior is steadier under pressure, reducing error spikes during large scans.

• Infinity Bots vote/list links now point to omniplex.gg, while the existing infinitybots webhook provider name stays unchanged for continuity.
• CleanerBot now starts with a slimmer invite permission set, and /start preflight clearly separates required permissions from feature-specific optional permissions.
• Admin and member DMs now include consistent quick links to the Support Community and cleanerbot.eu, so follow-up actions are one click away.
• Final setup success screens now include a one-click Check permissions action for immediate bot-channel permission validation.
• If a quick preset cannot be applied, CleanerBot now clears partial preset state before switching to guided setup, preventing stale blocker popups.
• /start now runs entry preflight immediately and shows a compact blocker summary with a Re-check preflight button on the welcome step.
• Pro-tip recommendation embeds are now gated behind completed setup, so unfinished onboarding no longer gets premature nudges.
• Guided /start steps now provide clearer explainer copy with automatic fallback to legacy text when translation keys are missing.
• /start language switching from step 0 now stays fully in-wizard and returns directly to the localized setup start.
• Wizard button clicks now switch to an explicit In progress state and lock other controls on that step to prevent duplicate actions.
• Periodic automations now surface missing permission blockers to staff earlier (poll posting, monthly champion posts, notification-thread cleanup, reward-role updates, and AHS compute failures) instead of failing silently.

Fixes

• Setup wizard delivery now handles Discord temporary send-disable windows more gracefully, so setup steps avoid hard failures.
• Setup wizard auto-create now clearly warns when a server hits Discord’s 250-role cap and tells admins to remove roles before retrying.

• Dead-channel reports now keep last_full_month strict, so channels reactivated in the current month are excluded, while /cohorts dead-channels can still switch to this_month_so_far when needed.
• Removed legacy owner-only maintenance and test slash commands to keep the command surface cleaner.
• Added webhook intake for discordservices.net, discollab, and vcodes.xyz.
• Poll Vote Joker now accepts verified votes from any configured webhook-enabled bot list instead of being tied to one provider.
• Unconfigured-server reminders now include an exact scheduled leave timestamp and a clearer /start call to action.
• Large-server decay scans now back off earlier under API pressure with adaptive member-fetch throttling.
• /purge_channel now uses adaptive pacing and retries under Discord API pressure, reducing failed heavy cleanup runs.
• Webhook rate-limit tracking now uses TTL cleanup and entry caps to prevent memory growth during sustained traffic.
• Activity Health Score recomputes now use leaner channel aggregation and realistic pressure thresholds, reducing unnecessary Lite Mode fallbacks.

Fixes

• Fixed dead-channel reports so whitelisted channels and channels inside whitelisted categories are no longer listed.
• Fixed /config show pagination so the Auto-Kick status and its toggle command stay together reliably across languages.
• Fixed periodic permission checks to respect /config toggle auto_provision_assets, so disabled auto-provision no longer recreates preset channels or roles.
• Fixed decay summary notifications so very large member lists are split across multiple messages instead of failing to send.
• Fixed overlapping full decay runs at startup, so large servers avoid duplicate scan pressure and get more predictable inactivity processing.
• Fixed rare setup-check and staff-reminder errors when a guild leaves or has partial config data, so decay runs continue without interruption.
• Fixed preset setup handling when a server removes CleanerBot mid-setup, so the wizard exits cleanly instead of surfacing noisy failure states.
• Fixed preset auto-provision races when the bot leaves a server mid-setup, preventing stale follow-up config writes after cleanup.
• Fixed AHS scoring so voice activity in whitelisted channels and whitelisted categories is no longer counted.
• Added missing labels for newly supported bot-list buttons so /help can show all configured links cleanly.
• Fixed a guild-config load edge case that could trigger extra setup checks, improving run stability and reducing unnecessary load on large servers.

• Added stronger RAM guardrails for bot and database containers plus proactive memory alerts, reducing outage risk during host memory pressure.
• Improved post-downtime catch-up for large servers with chunked scans and checkpoint progress, so long recoveries do not fail as one hard stop.
• Tier-limit alerts now DM admins once per month from the first over-limit reminder in that month, surfacing paused automations sooner.
• Unconfigured auto-leave now removes one oldest never-configured server per week and always excludes support, test, and premium servers.
• Added a Staff Advisories track for permission hygiene, giving admins explicit required, recommended, and optional permission guidance before automations degrade.
• /bulk_user_upload now shows a live ephemeral progress bar with seeded and failed deltas while each batch is processed.
• Added a Staff Advisories track for Premium bulk user upload, helping freemium servers decide when to upgrade and helping premium servers seed full rosters faster.
• /reset_all_decay_scores is now available to server admins on all tiers, so emergency decay resets are no longer premium-gated.

Fixes

• /bulk_user_upload now seeds first-time valid member IDs correctly, so bulk roster imports no longer fail mid-run.
• Auto-provision self-heal now keeps existing valid preset roles and channels instead of replacing already working assignments.
• Admin DM fallback contacts now refresh when the stored contact leaves the server or loses admin-level access.
• /reset_all_decay_scores now resets scores to zero without removing member join history, streak counters, or auto-kick dedupe records.
• /set_decay_score now updates only the member's decay score for existing records and no longer overwrites streak or join metadata.

• New /trust/ page gives admins one place to verify CleanerBot details faster (legal, security, and identity): https://cleanerbot.eu/trust/
• New /status/ page gives admins a live overview of bot, database, and webhook availability: https://cleanerbot.eu/status/

Improvements

• /config show is now easier to scan with pagination, a section jump dropdown, inline page numbers, and quick Website/Community links.
• Channel preset setup now collapses repeated non-blocking permission warnings, so admins can spot real setup blockers faster.
• Warning-notification comment threads now include a clear retention notice, auto-clean after the configured window (default 30 days), and run a legacy sweep for older leftovers (default 60 days).
• Botlist stat posting now retries once during temporary provider outages and logs shorter error snippets to reduce noise.
• Migration and event analytics defaults were hardened to make day-to-day operations more predictable across deployments.

Fixes

• Inactivity kick summaries now use localized score labels and no longer expose member IDs in member lists.
• More guardrail and fallback command/button messages now follow each server's configured bot language.
• Auto-kick risk warnings now show a clear count of kick-eligible members instead of percentages.
• Catch-up scans now treat temporary Discord API outages as transient and retry, so one unstable channel does not flood logs.
• Legacy warning-thread cleanup now skips missing archived-thread access as a non-blocking case, reducing startup warning noise.
• Decay default-role settings now auto-remove deleted role IDs, preventing recurring stale-role warnings.
• Setup Wizard Step 1 (Role Position) now has a reliable Back button in both preset and manual/explanatory flows.
• Startup delay fallbacks now match documented defaults, preventing early task starts when settings are missing.
• /my_score and /user_score now show "Unknown so far - tracking starts now." when no tracked activity is known yet.
• /user_score now returns a clear localized hint when the member argument cannot be resolved.

• Daily auto-repair now prioritizes servers with known setup blockers, so impacted communities are fixed sooner.
• Setup completion now detects large pending role-sync backlogs and stages role updates after enablement to avoid one large catch-up wave.
• Inactivity tracking now better reflects truly recent activity instead of delayed older events.
• Daily Activity Health Score processing is now more reliable during routine background runs.
• Reward-role streak handling is now more stable during high-concurrency periods.
• CleanerBot now recovers better from short background save hiccups to keep moderation flows uninterrupted.
• Healthy servers are now skipped during auto-provision sweeps to reduce unnecessary background load.
• /help quick links now show only currently active destinations (official website and community invite).
• Staff advisories now include a dedicated Monthly Dead Channels Report tip with a matching hero image for faster team alignment.

Fixes

• Fixed /set_decay_score being incorrectly premium-gated; manual decay corrections are now available on all tiers.
• Fixed poll-choice rendering where multi-digit break-length emojis could collapse into one clickable option; break-length polls now use clean 1/2/3/? choices.
• Added /config remove manual_kick_review_channel and matching /config show reset guidance to close a configuration gap.
• Fixed Auto-Kick display formatting in /config show so /config toggle auto_kick renders clearly.
• Fixed a timing edge case where older activity events could overwrite newer ones.
• Fixed a persistence edge case where last activity could move backward.
• Fixed a race condition that could occasionally create unfair reward-role grace reminders.
• Fixed a premium-alert issue that could block near-limit and limit-exceeded staff notifications.
• Fixed a daily score-update edge case that could occasionally interrupt Activity Health Score persistence.
• Fixed a startup edge case where newly detected servers could briefly miss background checks during database reconnection.
• Fixed a setup-save edge case that could add unnecessary warning noise during onboarding and rejoin flows.
• Fixed rare background save interruptions during temporary connection issues.
• Fixed duplicate fallback handling that increased edge-case error risk.
• Fixed the daily-check path so auto-provision remains off when auto-provision assets are disabled.
• Fixed a cleanup warning edge case so provider-wide vote-dedupe entries no longer trigger false invalid-guild alerts.
• Fixed a rare advisory-history save conflict so advisory delivery logs stay consistent.
• Fixed tip reset consistency so admin tip-cap resets stay in sync during database migration checks.
• Fixed premium entitlement cache persistence paths so migration-era background checks stay consistent.
• Fixed a server-leave cleanup edge case so departed-server data is removed more reliably without unnecessary fallback runs.
• Fixed a startup config-read edge case so temporary database reconnects no longer trigger noisy false error logs.
• Fixed startup cleanup noise by ignoring temporary unavailable-guild remove events, so only real guild leaves trigger purge logs.

• New Supporter Program: vote on Top.gg to unlock a 72h Supporter Role and help your server earn a next‑month tracking buffer.
• New /vote command with clear personal + server progress details, plus quick links.

Improvements

• Admin and staff views now surface Supporter Program status and reminders at the right moments.

Fixes

• None.

• Auto-provisioning now only adds missing permissions instead of removing existing access.
• Prevented duplicate welcome DMs from being sent to the same user.

Fixes

• Fixed cases where permission provisioning could remove permissions and flip between permission sets.
• Staff-only channels now keep @everyone hidden without unnecessary extra permission changes.

• Command lists now sync to bot listings with a simpler update flow.

Improvements

• Less disruption when settings are changed rapidly.
• Command imports now work better with third‑party bot lists.
• Tier limit alerts now add quick actions to upgrade or compare plans, explain paused automations, and confirm that tracking continues.
• Activity Health Score stays in full scoring mode unless resource guardrails trigger.
• Setup reminder messages now include Support and Setup Guide buttons and are clearer, faster to act on, and more helpful.

Fixes

• Activity tracking is more resilient during busy periods, with fewer missed updates.
• Staff advisory responses and buttons are more stable.
• Polling now causes fewer rate limit spikes.
• Command list formatting issues that could block bot list imports are fixed.
• Webhook handling for disq.ink events is more robust.

• Reduced ambiguity in rate‑limit notices by showing precise end times:
  • Cooldown messages now show exact end times for clearer transparency.
  • Auto‑Kick confirmations and guardrail notices include localized timestamps.
  • Vote Joker wait hints and Silent Kudos limits now show when you can try again.
• "Internal error" message now points you to the support community for faster help.

Fixes

• Fixed an issue in RSS feed parsing in /changelog.

• Preventive hardening to protect guilds from misuse, compromised admins, and accidental misconfiguration while keeping Auto-Kick transparent and predictable.
• Most guardrails trigger when Auto-Kick is enabled or when inactivity/decay settings change while Auto-Kick is on.
• Auto-Kick now enters a pending state on enable: a 24h cooldown, then a manual confirm. If nobody confirms, it expires after 7 days and stays off.
• If impact can't be estimated (for example during cache rebuilding), Auto-Kick runs only in Safe Mode with tiny caps until impact is known.
• Hard throughput caps (per run/hour/day) scale by server size. Hitting a cap pauses Auto-Kick and routes remaining cases to manual review.
• Servers with 100+ managed members require two eligible admins for high-risk confirmations; single-admin fallback requires a delayed re-confirm.
• Permissions are checked at action time (Owner/Admin/CleanerBot admin role). If someone loses eligibility mid-flow, another eligible admin must finish it.
• Critical toggle spam is rate-limited, but staff still see blocked attempts with who/what/why and the remaining cooldown.

New: Config History

• New command: /config history shows recent config and Auto-Kick audit entries for quick review.

• Monthly Dead Channels Report with a manual /cohorts dead-channels view for admins.
• The monthly report is toggled ON by default, which can be toggled via /config toggle dead_channels_report.

New: Category Whitelisting

• Category whitelisting is now available, so you can exclude entire channel groups from activity checks.
• New commands:
• /config add whitelisted_category
• /config remove whitelisted_category
• /config clear whitelisted_categories

Improvements

• Help pages were reorganized for clearer command grouping and easier navigation (/help).

• Scheduled event reporting is now available, including list (/event list), report (/event report), and CSV export (/event export).
• Event summaries can auto-post to staff channels when enabled.
• New staff advisory that highlights the /event attendance insights and how to use them.

Improvements

Inactivity DMs:

• Inactivity DMs are clearer and more neutral, and every message names the server that triggered it.
• A “Why?” button explains why you received the reminder and how to check your status.
• You can now mute inactivity reminders for a specific server, either from the DM button or by using /mute in that server. You can unmute anytime with /unmute.
• CleanerBot now recognizes server owners as trusted admins for protected commands. Access to configuration and setup tools now follows your configured CleanerBot admin role and server admin status, rather than Manage Server. Updated permission messages to reflect the new admin access rules.

Fixes

• Fixed a rare issue when sending a “quick poll”.

• Extended the managed member export /export_decay_data by user's system name (Pro/Scale only). Added a UX flow for large servers.
• Optimized localizations for English, German, French, Portuguese, and Spanish.
• Improved resilience when Discord has temporary API issues.

Fixes

• Made CTA buttons survive bot reboots where necessary; especially comments, advises, manual kick reviews, and Why? views.

• Permission provisioning now respects an extra per-channel buffer so the auto-provision flow avoids hammering the same channel in quick succession.
• Security hardening update: protections against replayed webhook events, burst limits for external services, and stricter public sharing link generation with dedicated secrets.

• Decay scans now honor a 90% interval threshold so near-due periods are processed promptly without drifting past midnight, keeping scores from staying stale even when the previous write happened late.
• Config display embeds again respect Discord’s length limits before sending, keeping the output reliable even when large sections of text are present.

Fixes

• Hardened the decay scoring loop so it never writes more than one interval’s worth of points at a time, preventing unexpected double-increments on the same day even if multiple scans fire close together.
• Some minor fixes under the hood, not visible to end users.

Threshold DMs (Warning + Inactive)

• Members can get localized DMs when they cross your warning active threshold.
• Sent once per threshold crossing (no repeats while they stay above).
• Respects setup completion, “automations on hold”, and your DM toggles.

• Defaults
  • Standard mode: ON
  • Ghost mode: OFF (opt-in anytime)

• Configure
  • /config toggle dm_warning
  • /config toggle dm_inactive
  • /config show

Improvements

• Poll command feedback is clearer (mode/disabled/perms/setup/content).
• Announcement comments/threads now attach reliably before sending.
• Fun polls: distinct emojis + fairer shuffle.
• Advises rewritten; added Threshold DMs advise.
• Performance: score calculation ~1h20 → 8m, reduction in log routine noise by -97 %, plus other optimizations.

Bugfixes

• Manual kick snooze modal now replies once (no duplicate-response errors).
• Fixed locale edge-case that broke onboarding/welcome DM localization.
• “Why?” explainer now matches your decay interval + increment.
• Onboarding wizard: expired interaction warning no longer throws an internal error.
• Fixed an issue with manual kick-reviews re-appear each decay run when snoozed.

Manual Kick Review

• Manual kick decisions now use clear states per member (Pending, Snoozed, Exempt) instead of hidden Decay Score resets, so you always see why someone is (not) being kicked.
• When a member hits the kick threshold in manual mode, mods can choose Kick, Snooze for a while, or Exempt from future manual kicks, and CleanerBot updates the review message in-place with a short summary.
• If a member becomes active again, their kick state is automatically cleared and they are treated like any other active member.

CleanerBot-Notification Comments

• For public CleanerBot notifications (e.g. inactivity role assigned, highscore celebrations, members kicked, etc.) in the configured warning_channel, CleanerBot now offers a “ Comment” CTA button. Clicking this button opens or reuses a public thread attached to that notification message, so members can comment without cluttering the main channel.

New Bulk User Prefetch Command (Pro & Scale Premium Tier)

• Added a new premium slash command /bulk_user_upload that lets admins paste a comma-separated list of up to 250 user IDs to pre-register known members.

Improvements

• Inactive/default roles created by the wizard now get distinctive colors (light red for inactive, light green for default) for clarity.

Bugfixes

• Auto-create admin role flow now advances properly after creation and assignment, preventing setup freezes.
• Preset apply flow no longer stalls on permission warnings and continues smoothly to completion.
• You can run /report_inactivity before onboarding finishes without the bot showing a spurious “role not found” error.
• Advisory messages include the vote CTA text and button again, while leaderboard replies keep the CTA out of the embed body.

• Discord notifications sometimes show user IDs instead of names due to caching issues on user side, especially for users not frequently seen. That’s why we do not link the user’s profile anymore, but display user names as text.

Bugfixes

• Prevented “thinking…” hangs by always replying after preset/config actions, even if server permissions are limited.

• Setup Wizard: Improved Onboarding texts for better guidance.
• Setup Wizard: Added a confirmation dialog, so the user is aware of auto-creation of roles and channels, if a preset has been chosen.
• Overall database connection performance improvements, reducing load and hardware resource usage.

Bugfixes

• Fixed „hang up“ command execution.

NEW : Decay Seriousness (tenure-based ramping)

• You can now make decay ramp differently for new vs. loyal members, on top of existing boost roles:
• This lets you protect long-term members a bit more, or treat very new joins more strictly, while still stacking with your existing boost roles.

• Configure under /config → Decay settings using:
  • /config set seriousness_percent 0|10|20|30|40|50
  • /config set seriousness_newbies days:<Y>
  • /config set seriousness_loyals days:<Z≥Y>
• Members who joined:
  • less than Y days ago decay slightly faster,
  • between Y and Z days decay normally,
  • more than Z days ago decay slightly slower (loyalty bonus).
• Defaults are 0/0/0, so nothing changes until you explicitly turn it on.

NEW : lite-mode tracking & admin failure notification

• Lite onboarding mode: Immediately after installation, CleanerBot starts ingesting activity, calculating decay scores, and serving read-only views (/my_score, /user_score, /leaderboard, /decay_top10, /report_inactivity, AHS), while warnings, inactive roles, removals, and public reposts remain disabled until setup is completed.
• Safer setup completion: When setup is completed, CleanerBot runs a dry-run against your warning/role/removal thresholds. If any members are already above a threshold, it opens a private “pending automations” grace window (confirm button or automatic activation after 3 decay intervals) instead of firing actions immediately.
• Admin contact & alerts: A primary admin contact is stored and kept up to date and used as fallback target for private alerts when the staff channel is missing or forbidden; notifications never fall back to public channels.

Bugfixes

• Fixed a TypeError in /purge_channel command.

• Added two new staff advisories: training mode tips and language/tone alignment guidance. Enhanced description and content of the existing ones for a better understanding.
• Extended and rephrased CleanerBot’s Ethics Statements for a better understanding and to underline our commitment.
• Self-heal skips entirely if CleanerBot lacks Manage Channels/Roles, avoiding unnecessary retries.

Bugfixes

• Eliminated cases where preset-created staff channels could block CleanerBot from posting after setup: Preset setup now prioritizes granting bot and admin access before tightening channel visibility, preventing lockouts during auto-provision.
• Prevented daily auto-provision (self-healing) from touching healthy servers without cause.

• CleanerBot now sends a welcome DM to the user who invited it to a server, including a short step-by-step guide to complete setup and make the bot fully functional.

Improvements

• Removing discordbotlist.com and discords.com from the quiz “joker” list due to their highly unstable webhook handling. They’re not reliable enough to support this feature.

Bugfixes

• Stopped “Configuration Issues Automatically Repaired” messages from reappearing when permissions were already resolved.
• Fixed polls/quizzes not working for Chinese language.

New self-healing mechanism

• CleanerBot now includes self-heal: it re-applies preset channel/role overwrites, recreates missing preset assets, and restores the bot’s view/read access on channels where permissions were removed. Any repairs are posted in the staff channel to be fully transparent, and you’ll only get a warning if a fix isn’t possible or other permissions are still missing.

New configuration presets: Gaming / MMO / RP, Creator / Sub, Education / Bootcamp, SaaS, NGO / Volunteer

• Added new segment-based setup presets in the /start wizard (Gaming / MMO / RP, Creator / Sub, Education / Bootcamp, SaaS, NGO / Volunteer), each with its own emoji label and tuned inactivity behaviour.
• Introduced a preset preview step: after choosing a preset, admins see a detailed summary of decay, activity sources, polls, CTAs, streaks and reward roles, with clear Back/Continue options.
• Added dedicated ghost-mode presets for SaaS and NGO servers that run fully in the background: no member-facing messages, while staff still get clean activity insights in staff-only channels.
• Roles and channels for inactivity management (e.g. inactive role, activity hub, review channels) are automatically created or re-used with sensible defaults, so most servers can start with one click.

Improvements

• Onboarding: Smarter automation defaults: each preset now comes with pre-configured activity sources, thresholds, polls and streak logic tailored to the server type, reducing setup time and misconfigurations.
• Reward roles are safer and clearer: roles can be assigned without always triggering public announcements, and ghost-style setups keep streak information confined to staff-only channels.
• Tuned French translation here and there.

• Configurable inactivity role handling: We added a new Inactivity Role Handling setting that lets you choose how CleanerBot manages roles when members become inactive.
• Inactive/Default Swap (default): Keep all special roles and only swap between your Default Member Role(s) and the Inactive Member Role.
• Reset to Inactive Only: When members become inactive, remove all roles except @ everyone and the Inactive Member Role. When they become active again, only Default Member Role(s) are restored.
• Exempt members are never modified by the inactivity engine in either mode. You can view and change this setting via /config set inactivity_role_mode.

Fixes

• Inactivity handling now respects exempt roles everywhere, including manual and automated removals.
• Prevented confusing “inactive/default role missing” alerts for Ghost-mode guilds so staff no longer get warned about intentionally skipped roles.

• Setup wizard now locks down newly auto-created staff channels so only admins and CleanerBot see them, keeping sensitive automation steps private out of the box.
• Ghost-mode onboarding now auto-cleans missing roles/channels so re-running /start feels smoother for returning guilds.
• Wizard summaries keep the full completion text while still showing Ghost-mode “skipped by design” notes in a dedicated section.
• Setup reminders now respect a 72-hour onboarding grace period so brand-new servers can finish configuring without nagging.

Fixes

• Fixed an issue where manual kick denial failed to close the confirmation view, causing it to reappear indefinitely.
• /report_inactivity embeds no longer retain the previous page’s height, keeping each page readable regardless of content length.