# 📊 Server Stats Bot – Comprehensive Analytics for Discord Communities

**Server Stats Bot** is a powerful analytics solution for Discord servers, built to help admins understand their community's activity patterns. With detailed tracking across messages, members, channels, and roles, it provides the insights you need to grow and manage your server effectively.

---

## 🚀 Getting Started

1. **Add the bot** to your server
2. **Run `/setup`** and click Enable
3. **Optionally** exclude channels or categories you don't want tracked
4. **Optionally** select roles to track membership counts
5. **Wait a few days** for data to accumulate
6. **View stats** with `/stats summary` or generate detailed reports

*Data collection begins immediately after enabling. Historical reports require sufficient data collection time.*

---

## ⚙️ Key Features

### 📈 Comprehensive Tracking

* **Message Analytics** – Track message counts across all channels
* **Attachment Monitoring** – Count images, videos, and files shared
* **Reaction Stats** – Monitor reactions given and received
* **Member Joins & Leaves** – Track server growth and churn
* **Voice Activity** – Peak voice channel usage metrics
* **Unique Sender Counts** – See how many different users are active

### 📊 Multi-Level Insights

* **Server Overview** – See your entire server's activity at a glance
* **Channel Breakdown** – Discover your most active channels
* **Member Analytics** – Individual user engagement metrics
* **Role Tracking** – Monitor member counts for specific roles over time

### ⏱️ Flexible Time Ranges

* **1 Week** – Recent activity snapshot
* **1 Month** – Short-term trends
* **3 Months** – Quarterly analysis
* **4 Months** – Extended trend view
* **6 Months** – Half-year insights
* **12 Months** – Full year of data

### 📋 Real-Time Summary

* **Today's Stats** – Quick overview of current day activity
* **Active Channels** – Channels with activity today
* **Active Users** – Members who engaged today
* **Join/Leave Count** – Member changes for the day
* **Peak Voice Users** – Maximum concurrent voice users

### 🎨 Shareable Stats Pages

* **Web-Based Charts** – Beautiful visualizations on discordlabs.org
* **Customizable Metrics** – Choose exactly what data to include
* **Shareable Links** – Generate links valid for 7 days
* **Multi-Metric Support** – Compare different stats on one chart

### 🛡️ Granular Controls

* **Category Exclusions** – Ignore entire channel categories
* **Channel Blacklist** – Exclude specific channels from tracking
* **Role Tracking** – Select up to 10 roles to monitor membership
* **Enable/Disable Toggle** – Turn analytics on or off instantly

### 🔒 Privacy First

* **Opt-Out System** – Users can disable personal tracking anytime
* **User ID Only** – No usernames or personal info stored
* **Server Control** – Admins decide what gets tracked
* **Transparent Policy** – Clear privacy policy and terms of service

---

## 🎮 Available Commands

### User Commands

* `/help` – View detailed help with all features explained
* `/privacy tracking:on/off` – Opt-in or opt-out of personal tracking

### Admin Commands

* `/setup` – Configure analytics for your server
  * Enable/Disable tracking
  * Ignore channels and categories
  * Select roles to track
* `/stats summary` – Quick overview of today's server activity
* `/stats server [duration]` – Generate server-wide statistics report
* `/stats channel [channel] [duration]` – Channel activity analysis
* `/stats user [member] [duration]` – Individual member statistics
* `/stats roles [duration]` – Role membership trends over time

---

## 📐 Available Metrics

**Server Metrics:**

* Messages, Attachments, Reactions
* Unique Senders (active members)
* Member Joins & Leaves
* Peak Voice Users
* Total Member Count
* Boost Count, Role Count

**Channel Metrics:**
* Messages, Attachments
* Reactions, Unique Senders

**User Metrics:**
* Messages Sent
* Attachments Shared
* Reactions Given
* Reactions Received

---

## 💡 Why Server Stats Bot is Different

Unlike simple counter bots, Server Stats Bot provides a **complete analytics platform** with:

* **Historical Data** – View trends over weeks and months, not just today
* **Shareable Reports** – Generate beautiful web charts to share with your team
* **Multi-Dimensional Tracking** – Server, channel, member, and role analytics
* **Privacy Controls** – Users can opt-out, admins control tracking scope
* **Zero Configuration Start** – Enable with one click and start collecting data
* **Automatic Daily Aggregation** – Data is processed and stored efficiently every day
* **Role Growth Tracking** – Unique feature to monitor role membership over time

Whether you're managing a **small community** or a **large public server**, Server Stats Bot gives you the data-driven insights to understand engagement and grow your community effectively.

---

## 🔐 Privacy & Data

* Users can opt-out anytime with `/privacy tracking:off`
* Only Discord IDs are stored – never usernames or messages
* Server admins have full control over what channels are tracked
* Generated stat links expire after 7 days
* Full privacy policy available at docs.discordlabs.org

Server Stats Bot

Track your server's pulse. Get powerful, real-time stats, member insights & channel analytics. 

Voting for Server Stats Bot

Do you want to support us?