Stats only start tracking from the time you invite the bot, not before. Non-message stats must be tracked real-time. Stats may take up to 15 minutes to display in commands and the dashboard.
Keep following this guide and you'll definitely have stats by the end!
Message, Voice, Status (online, dnd, idle), and Member Count stats all start tracking immediately with no setup. Just wait a few minutes from your first message or voice minute to see it show in your server's new and shiny dashboard. You can find a link to your server's dashboard on your Me page.
The only tracking that needs to be configured is tracking Activities (games, applications, etc.) which will be covered in part 4. Website Dashboard.
Running Your First Command
To make sure the bot is functioning correctly, run the
s?help by typing it in a channel the bot can see.
If the bot is not responding and you're sure it has the correct permissions, or you have any other questions, you can contact us for help in our support server.
When selecting a channel, the bot will show in the members list on the right-hand side if it can also see that channel
(demonstrated below). If you cannot see the bot, then check to make sure it has the
Read Messages and
Send Messages Discord permissions and that the channel has no overwrites blocking them.
Statdocks (Channel Counters)
Statdocks are Statbot's channel counter solution and provides the best experience out of any alternatives.
If you want to start with preset counters, all you need to do is run the
s?counter setup command. After you confirm,
the bot will set up the most common counters for you! It will also give you a bunch of tips to help you get the most out
If you want even more customization, such as custom names or timezones, the dashboard has more than twice the features the bot has for Statdocks including even more counter types and the ability to add multiple counters to one channel!
You can read more about Statdocks under the [Statdock] section of these docs.
s?counter is an alias for
s?statdocks. You can see many more command aliases with the
s?alias command and at
the bottom of every command's
s?help page which we'll explore in the next section.
Statroles (Automatic Role Giving and Removing)
Statroles assign and remove roles automatically based on your settings! A member gets and keeps the Discord role so long as they meet the requirements of the Statrole. When they no longer meet the requirements, the bot removes the role. This makes this the perfect system for rewarding your consistently active members!
A Statrole has many settings available to it in the form of Conditions. Conditions come in the form of Message, Voice, Activity, Joined Age, Account Age, and other Statroles. There is also a special Match condition for grouping the others with AND / OR logic.
Because Statbot stores historic data, a new Statrole will instantly have access to those historic stats. This means that the bot can modify members' roles as you create or change Statroles giving you the freedom to test different settings and tune them all without having to worry about losing weeks or even months of data.
You can read more about Statroles under the Statroles section of these docs.
Why don't I see any stats?
If you recently invited the bot, you should see your hard-earned stats flooding into your dashboard within a half hour!
Also remember that it takes two points to make a line on a graph. Because Statbot shows stats daily by default, it may take up to 24 hours for your graphs to start showing lines. You should still see a lonely point and the top tables should begin populating!
How to stop Statbot from tracking channels?
First, make sure that Statbot doesn't have the
Administrator Discord permission. Then deny the bot the
(for text) and
See Channel (for voice) permissions for the channels you don't want tracked.
What timezone is stats in?
All graphs in Discord commands are in the UTC which is the timezone GTM±0. A "day" on the website is also determined by UTC, but the website will move the data point depending on your timezone.¹ We plan to have a setting for this in the future!
Can I see stats older than 14 days?
Yes! This is controlled by the
Lookback setting which is covered in part 5. Common Settings, you can change this
up to 30 days for free and even use a specific date to "soft reset"!
Channel Counters? Role Giving?
Statdocks (channel counters) and Statroles (stats-based roles) are powerful tools for communities to make the most of their stats. After you get comfortable with Statbot, you'll definitely want to make use of them!