1. Turn Analytics on
Open your server's Services page in the dashboard and switch Analytics on.
What gets recorded
From that moment the bot records:
- every regular and reply message (system messages such as join notices, boosts and pins are not counted)
- every voice session
- every join and leave
Bot accounts are skipped by default.
2. Run the setup wizard
Open Analytics in the dashboard. Until the wizard has run, the Home page sends managers to the Setup page: press Run setup there. To keep some channels out of the history import, leave them out first (step 3).
What setup creates
Run setup creates a private #analytics-alerts channel, or reuses a text channel with "analytics" in its name. It also:
- saves the defaults, with bots excluded
- creates an "Activity Drop Warning" alert that fires when messages drop 30% against the previous week
- starts an import of up to 365 days of message history
The import walks every text channel, its active and public archived threads and its forum posts. It counts only regular and reply messages, and it records a join for each current member on the day they joined. Progress shows under History on the Settings page.
Channels excluded before the wizard runs are left out of the import. You can re-run the wizard later.
3. Decide what not to count
On the Analytics Settings page, under What counts, keep Leave bots out on (recommended). Then pick any channels and roles to skip under Channels and roles to leave out.
How leaving out works
- Channels to leave out: threads and forum posts inside them are left out too.
- Roles to leave out: members currently holding one are left out. A role change is picked up within half an hour.
- Exclusions stop new recording and hide those channels and members from the server-wide numbers. A member's own card still shows what was recorded before.
4. Check the timezone and how long data is kept
On the same page, Time zone follows your server by default. Keep data for offers 30, 90, 180 or 365 days (90 to start).
Time zone and retention details
- Time zone defaults to "Follow the server time zone", which is set on the Bot Settings page. Pick a zone here only when Analytics should differ from it. See Server time zone.
- Every server can pick any of the Keep data for choices.
- Detail older than the window is removed every night. Shortening the window deletes the difference at the next nightly run.
- Charts and rankings cannot look back further than this window.
5. Try the commands
Run /server for a public overview card and /me for your own stats card.
Every command
/serverposts a public overview card./meposts your own stats card, with a button to hide it./leaderboardranks members by Messages, Voice Hours or Voice Sessions (0 days means all time)./topgives four ranked lists at once, or one ranking per page./invitesranks who brought in the most members who are real and still here. It answers privately unless a server manager setspost./chart messages,/chart voice,/chart members,/chart channeland/chart memberdraw per-day charts over 7, 14, 30 or 90 days. They are private unless you setpostto yes./info server,/info user,/info role,/info channel,/info invite,/info emojiand/info avatarshow what Discord itself knows about each.
Each command has its own page, for example /server.
6. Open the dashboards and style the cards
Open Analytics in the dashboard to see your numbers. To style the cards, click Card designer on the Sharing page.
The 12 pages
The Analytics menu has 12 pages in four groups:
- Home and Your charts (the charts you build yourself).
- Your server: Growth, Activity (with Chat, Voice, Online and Playing tabs), Best times, Channels and Members.
- Put it to work: Role rewards, Counters, Alerts and Sharing.
- Housekeeping: Settings.
A member, a channel, a day or an hour of the week opens in a side panel.
What the card designer sets
- The colours, background image and sections of the stats card.
- The Stats cards on switch. Turning it off also stops
/stats,/meand/user. - A leaderboard section for the
/leaderboarddefaults: metric, window, number of entries (5 to 25), time frames, medals, avatars, progress bars and your rank line.
7. Share numbers outside the dashboard
On the Sharing page, use Who can open the dashboard to choose who can open the public stats page. The default is Private.
The choices and share links
- Private, the default: "The link is off. Nobody outside your dashboard sees these numbers."
- Members only
- Role restricted
- Public: "Anyone with the link. Members are never shown, only server totals."
The public page lives at /a/ followed by your server ID. It has Overview, Messages, Voice and Members pages.
Members share their own card with "Open & share" on /me and hide it with "Hide my card". Managers can see who hid their card and can reset every share link from the Sharing page; old links then stop working.
8. Optional: reward activity with roles
On the Role rewards page, a reward gives a role when a member meets its conditions. The bot needs Manage Roles, and its own role must sit above the reward role.
Conditions and schedule
Conditions can be:
- a minimum or maximum on a metric such as messages, voice hours or voice sessions
- a window in days (0 means all stored data)
- a top rank or top percent
- a minimum reached on at least so many days
Up to 8 conditions combine with all or any. Each reward runs on a schedule from every 10 minutes to once a day. On a large server, a run with a great many roles to give or take is spread over several checks, ten minutes apart, so role rewards on other servers are not kept waiting for it to finish. Rewards it kept waiting go first at the next check.
All-time rewards on messages, voice hours and voice sessions use totals that data retention never removes.
Rank ladders
A rank ladder is a set of rewards that replace each other, such as Novice, Regular and Veteran. Type the same name in Rank ladder (optional) on each of them.
- A member keeps only the highest rank they have earned. The lower ranks are taken away and are not given back while the member has the higher role.
- The order is your server's own role order: the role that sits higher in Server Settings, Roles is the higher rank.
- The ranks of a ladder are checked together, as often as the one checked most often.
- A member on a reward's ignore list is left alone by that reward.
- A reward set to Permanent keeps its role when the member moves up.
- Pausing a reward stops its rank from being given or taken away. A member who already holds that role keeps their place in the ladder and does not hold the ranks below it.
- Put the rank roles in rank order in Server Settings, Roles, with the highest rank on top. When the bot can tell that a rank on top asks for less than an active rank below it, the ladder is put on hold and nothing is given or taken. The Role rewards page names the two roles. The ladder starts by itself once the order is right.
- The bot cannot tell for ranks on different metrics or for ranks with a maximum or set to Inverted: keep those in order yourself.
- Discord puts a new role at the bottom of the list. When you add a rank, move its role into place. Its reward can stay paused until then: a paused rank at the bottom does not put the ladder on hold.
- On a server where members already hold several ranks, the lower ones are taken away up to 100 at a time, every ten minutes, until they are all gone.
9. Optional: show live numbers in channel names
On the Counters page, or with /counter in Discord, turn a channel's name into a live number. Quick setup (or /counter setup) makes a Server Stats category with All members, Members and Bots counters. The bot renames the channel every 6 minutes when the number changes.
Counter kinds and options
Twenty kinds are on offer:
- members, members with a role, in voice, online or playing something (these two need the Presence intent)
- channels by type or category, roles, emojis, stickers, boosts and the boost level
- bans (the bot needs Ban Members), members without a role or still in rules screening
- Bluesky followers and players on a Minecraft, FiveM or Steam game server
- a clock, a countdown and activity counts
Up to 4 fit in one name.
A counter with a goal reads 1,204 / 2,000. It can post your message in a channel when it gets there, then raise the goal by a step. Every number can read 1,234, 1.2K or 1234.
To reword a counter, rename the channel in Discord and keep a number in the name: the first number is the one the bot keeps updated. Run /counter check to list anything that stops a counter from updating.