Automation & utility

Discord server health score: one weekly number and what to do next

Server Health Score gives your community one number from 0 to 100 every week, built from activity, retention, moderation load and setup. Next to it you get three recommended actions that link straight to the console page where you can act. It is plain maths on counters BotGG already keeps: no AI, no new tracking and no message content.

  • Works on the Free plan
  • 1 slash command
  • Set up in the web console
staff-roomDiscord preview

DanaToday at 20:14

/healthscore

BotGGBOTToday at 20:16

Server health · Night Owls
74 / 100
What makes up the score
Activity 81 · Retention 66
Moderation load 90 · Setup 62
Recommended actions
1. Answer 3 overdue tickets: people are waiting past your response time.
2. Reach out to 4 regulars going quiet: a personal message brings regulars back more often than anything else.
3. Set up a welcome message: new members who feel seen stay longer.
Open dashboard

Only you can see this

The weekly score in Discord

What you get

Four parts, one score

Activity counts for 35, retention for 30, setup for 20 and moderation load for 15. Tiles show each part, so you can see what moved the number.

Three actions, not a wall of advice

Waiting work like overdue tickets, Doctor findings and regulars at risk comes before suggestions. Each action links to its console page, and you can dismiss one.

Fair to any server size

Activity is measured against a target that fits your size: 35 % active at 100 members, 20 % at 1,000 and 11 % at 10,000.

Honest about missing data

A part with no data is left out and the others are scaled up, never counted as zero. With fewer than three parts the score says it is based on limited data.

Delivered your way

See it in the console dashboard or with /healthscore, get an optional DM as the owner, or post it to a staff channel. The DM has a button to stop it.

A trend you can follow

A trend chart with a data table shows how the score moves from week to week. Your server keeps 8 weeks on Free, 52 on Pro.

How it works

  1. Open the dashboard

    Open https://console.botgg.app, choose your server and go to Server Health Score in the Utility section. The dashboard shows a labelled live calculation even while the feature is off.

  2. Turn on the weekly score

    Enable the feature and pick the weekday and hour. Optionally add the owner DM and a staff channel.

  3. Read the score

    Each week the score is stored with its parts and three actions, also if a DM can’t be delivered. Staff with Manage Server can check it any time with /healthscore.

  4. Act on it

    Open an action to go to the right page, or dismiss one you don’t need. Next week’s score shows whether it helped.

What goes into the score

Server Doctor audits your configuration. The Health Score looks at the whole community, and the Server Doctor score is only one of its four inputs. The rest comes from what BotGG already counts: Server Insights, Churn Radar and Owner Digest.

If you see a low confidence note, fewer than three parts had data, so treat the number as a rough guide. Turning on Server Insights gives a fuller picture. When no part has data there is no score, and that week is skipped. Flows can react when a new score is calculated or when it drops by the amount you set.

  • Activity: active members against a size-aware target, or messages per member without Insights, plus the trend against last week
  • Retention: the 7-day stay rate of recent joins, joins against leaves, and regulars at risk
  • Moderation load: cases and AutoMod hits per active member, overdue tickets and open appeals
  • Setup: your Server Doctor score

Slash commands

Generated from the bot’s real command definitions. Full list on the commands page.

/healthscoreThis server’s weekly health score and what to do next

Commands

Free vs Pro

Every feature works on the Free plan. Pro raises the limits and unlocks extras.

LimitFreePro
Health Score history (weeks)852

What Pro adds See pricing

Frequently asked questions

How do I know if my Discord server is healthy?

Turn on Server Health Score in the BotGG console. Each week you get a 0–100 score from activity, retention, moderation load and setup, with three things to do next.

How is this different from Server Doctor?

Server Doctor audits your configuration. The Health Score rates the community as a whole, and the Doctor’s score is one of its four inputs.

What does low confidence mean?

Fewer than three parts of the score had data, so the number is only a rough guide. The usual fix is to turn on Server Insights.

Does it use AI or read messages?

No. It is plain maths on counters BotGG already keeps. No message content is read and no member data is stored for the score.

Who can see the score?

Anyone with console access to the feature and members with Manage Server through /healthscore, which replies privately. It reaches a channel or a DM only if you set that up.

Ready to level up your server?

Add BotGG for free, then switch features on in the web console.