Skip to main content

Commands - Stats

Permissions Check!

Make sure Statbot has the following permissions for the stat-related features:

  • View Channel — Tracking stats. Generally not an issue unless you have this turned off by default.
  • Attach Files Embed Links — Responding to commands. (Both /slash and s?prefix.)
  • Send Messages Read Message History — Responding to s?prefix commands.
info

Many settings influence the stats you and your members see in Discord. Most important is the Lookback setting which defaults to 14 days. You can change the default Lookback with the /settings command, or on the Dashboard.

Actions​

The stats commands have many shared actions in the form of persistent buttons or select menus. These may change depending on the current view.

ButtonNameFunction
RefreshEdits the message with the most recent stats.
ChartGoes to the equivalent /chart view for the current response.
OverviewGoes to the equivalent /stats view for the current response.
LookbackChanges the Lookback used for this response.*

* Custom lookback requires the Drilldowns Upgrade.

Commands​

Commands that display stats about the server and its members. While other pages in these docs are split by command, this page will be split by type of stats to make it easier to see what stats are available.

/stats & /chart​

These commands have subcommands found in the sections below.

Activities​

Information about the activities (games & applications) members of your server interact with. Can be controlled with the Activity Filter setting.

info

Tracking and viewing Activity states (games & applications) requires the Data+ Upgrade, in addition to turning on Activity Tracking.

CommandsDescriptionUsage
/activity — /stats activityA breakdown of the top 10 activities./activity
/chart activityA chart of up to the top 10 activities./chart activity
stats activity command response
/stats activity response
chart activity command response
/chart activity response

Channel​

Information about a given channel.

CommandsDescriptionUsage
/channel — /stats channelAn overview of the channel's stats./channel #channel
/chart channelA chart of the channel's stats./channel chart #channel
stats channel command response
/channel response
chart channel command response
/chart channel response
info
  • Categories and Voice channels will display both text and voice data.
  • "Contributors" is the number of unique users that participated in that period.

Members​

Information about the server's member count.

CommandsDescriptionUsage
/chart memberA chart of the server's member count./chart member
chart member command response
/chart member response

Messages & Voice​

Because of the similarity of these commands, this section will cover both Message and Voice commands.

CommandsDescriptionUsage
/messages — /stats messagesAn overview of the server's message stats./messages
/voice — /stats voiceAn overview of the server's voice stats./voice
/chart messagesA chart of the server's message stats./chart messages
/chart voiceA chart of the server's voice stats./chart voice
messages command response
/messages response
chart messages command response
/chart messages response
info
  • "Contributors" is the number of unique users that participated in that period.

Server​

An overview of the server's stats.

CommandsDescriptionUsage
/serverAn overview of the server's stats./server
server command response
/server response

Statuses​

Information about the server's aggregate user statuses. (i.e., online, dnd, idle)

CommandsDescriptionUsage
/chart statusA chart of the server's status count./chart status
chart status command response
/chart status response

Top​

Ranks channels and users in the server. There are 5 pages to navigate between from when running the /top command.

CommandsDescriptionUsage
/topThe Top menu starting on the "Overview" page./top
top command page select
/top page select
  1. Overview
  2. Top Message Users
  3. Top Voice Users
  4. Top Message Channels
  5. Top Voice Channels
top command overview response
/top "Overview" page response
top command message channels response
/top "Top Message Channels" page response
info
  • Rank is determined by the server's settings.

User​

Information about a user's stats in the server.

CommandsDescriptionUsage
/user — /stats userAn overview of the user's stats./user @user
/meAn overview of your stats./me
/chart userA chart of the user's stats./user chart @user
user command response
/user response
chart user command response
/chart user response