Documentation
Getting started
comcom analytics is a free dashboard that automatically tracks your Discord server’s messages, reactions, voice and member activity, and turns them into insights on growth and engagement. Setup takes three steps.
- Go to analytics.comcom.app and sign in with Discord.
- Add the bot to a server where you have the "Manage Server" permission.
- Tracking starts from the moment you install — data flows into the dashboard automatically.
Customize
Exclude bot activity
Filter out other bots’ messages as noise so you see only human members’ activity.
Filter channels
Choose which text/voice channels to analyze. Exclude staff or log channels to keep the numbers true to your community.
Viewer access
Grant view-only dashboard access to non-admin staff members.
Around the dashboard
The left-hand navigation covers every angle of your community. For a screenshot-by-screenshot walkthrough of each screen, see /product.
| Page | What it shows |
|---|---|
| Summary | Overall trends, the weekly AI summary and member breakdown in one place. |
| Channels | Text/voice channel rankings and trends. |
| Roles | Member counts and activity by role. |
| Members | Per-member activity history and cards. |
| Comparison | See where your server sits among similarly-tagged servers, as anonymized relative metrics (requires setting a category tag). |
| Traffic | New-join / leave trends and an inflow ranking by invite link. |
| Stats | Message, reaction and voice time series, plus a channel scatter plot. |
| Action logs | Search and browse individual reaction and voice log entries. |
Discord commands
Everything is available through the /comcom command (subcommands) in Discord. Some subcommands may vary by environment.
| Command | What it does |
|---|---|
| /comcom member <user> | Member analytics card — animated LV/EXP HUD ⇄ detailed dashboard. |
| /comcom channels | Server overview dashboard ⇄ channel ranking (by messages / by voice). |
| /comcom leaderboard | Server EXP leaderboard + your rank. |
| /comcom heatmap | Activity heatmap (weekday × hour, messages + voice). |
| /comcom room | Pixel-art "room" GIF + button navbar. |
| /comcom poll | Create a community poll (question / options / duration / multi-select). |
| /comcom help | List all commands. |
| /comcom slot | Randomly pick one member, as a GIF (no prizes). |
EXP / Level / Rank
EXP is a single cumulative value from recorded activity — it only ever grows.
dailyEXP = min(messages,100)·1 + max(0,messages-100)·0.25 // soft cap
+ min(voiceMinutes,240)·0.5 // 4h/day cap
+ reactionsGiven·0.5 + reactionsReceived·1 + mentionsReceived·1
EXP = Σ dailyEXP (all recorded days, only grows)
Level = floor( sqrt(EXP / 50) )Tier titles by level: Newcomer (0–4) → Regular (5–11) → Active (12–21) → Veteran (22–34) → Elite (35–49) → Legend (50+). All-time EXP, level and rank refresh nightly.
Guidelines
Tips
- Voice activity accrues after install; all-time rank appears after the nightly batch runs.
- Looking at messages, voice and reactions together surfaces members who contribute even if they post little.
- Use the heatmap to find active hours and time your events and announcements.
Privacy
A member card can only be run by the member viewing themselves, or by a Manage-Server admin; button actions are limited to the invoker. No PII such as email addresses is ever exposed — on the dashboard or via the API/MCP.
Reading the data
Figures are based on real data from install onward. All-time EXP, rank and all-time voice are updated by a nightly precompute, so right after install some values may show as "pending".
FAQ
Is it free?
Yes. The core dashboard and commands are completely free. The Pro plan (priced by server size) adds features like API/MCP access.
Can I get historical data?
No. Tracking starts at install time; history cannot be back-filled.
My commands aren’t showing.
Global commands can take a few minutes to propagate. Press Ctrl/Cmd+R in Discord to clear the client cache.
What happens to our data if we remove the bot?
Removing the bot stops dashboard access. Re-adding it later resumes tracking from that point on — the gap while the bot was removed is never back-filled.
Can we compare multiple servers, or benchmark against others?
Yes to both. Servers you run yourself can be combined into one view from the top-right of Summary and other pages (admin-only, every combined server must be on Pro). Benchmarking against other servers uses an anonymized relative comparison once you set a category tag on the Comparison page — no other operator ever sees your server name or member details.
Private channel permissions
Discord's per-channel permission overwrites take priority over server-wide role permissions. So even if the bot's role has "Manage Server", the bot can't read a channel (or category) where those channel-level overwrites block it.
- Right-click the channel (or category) → Edit Channel → Permissions, then add the bot's role or the bot user and set "View Channel" to Allow.
- If many channels are private, the simplest fix is to remove the bot and re-invite it with the Administrator permission — that grants access to every channel.
The dashboard warning clears within a few minutes of the permission change taking effect.
Troubleshooting
Data looks empty or sparse right after install
That's expected — tracking starts at install time, so there's little history yet. Numbers stabilize after a few days to a week of normal activity.
Voice numbers lag behind other metrics
Some voice aggregation runs in a nightly batch, so it can trail messages/reactions by up to a couple of days before catching up automatically.
Member card won't run, or buttons don't respond
A member card can only be run by the member viewing themselves, or by a Manage-Server admin — and its buttons only respond to whoever ran the command, so other members clicking them will see nothing happen.
Getting a permissions error
Installing or changing settings requires the "Manage Server" permission on Discord. If the error persists after confirming your permissions, reload the dashboard to refresh its cached permission data.