Setting Up Statbot


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 10 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


If you're not yet familiar with the idea of "bots" and "commands", skip to the next section. Or, if you're not familiar with Discord permissions, you can read more about them on our blog for community builders!

To make sure the bot is functioning correctly, run the s?help command in a channel the bot can see.

The bot will show in the members list on the right-hand side of the server if it can see that channel you have selected (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 the Read Messages permission.


If the bot is not responding and you're sure it has the correct permissions, or you have any questions, you can contact us for help in our support server.

Statdocks (Channel Counters)

Statdocks are Statbot's channel counter solution. It is the most customizable solution of any counter bot and brings most of their paid features, like custom channel names, to you for free. Display your stats your way!

If you want to start with preset counters, all you need to do is run the s?counter setup command. This will prompt you for a quick confirmation and then set up the most common simple counters for you! It will also give you a bunch of tips to help you get the most out of Statdocks.

You can create more preset counters with s?counter create while s?counter create custom will give you more options and the ability to make counters with custom names.

But it doesn't stop there, 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 see in the next section.

Statroles (Automatic Role Giving and Removing)

Statroles assign and remove roles automatically based on settings like minimum and maximum values of messages, voice minutes! A member gets and keeps the Discord role so long as they meet the criteria of the Statrole. When they no longer meet the criteria, the bot removes the role. This makes this the perfect system for rewarding your members with constant activity!

A Statrole can be one of three Stat Types: Messages / Voice / Activity (games and applications). Each Statrole has its own settings apart from your general stats, so you can fine-tune them custom Lookbacks, etc.

Because Statbot stores historic data unlike levelling bots, a new Statrole will instantly have access to the server's history Statbot has tracked. 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 Statrole section of these docs.

Quick FAQ

Why don't I see any stats?

If you recently invited the bot, you should see your hard-earned stats flooding into your dashboard in just a few minutes!

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?

Make sure that Statbot doesn't have the Administrator Discord permission and "Deny" the bot the Read Messages (for text) or See Channel (for voice) permission for the channel you don't want tracked.

You can also whitelist or blacklist channels and categories which allows you to hide them from your general stats while still keeping them tracked for other features! We'll talk more about this in part 5. Common Settings.

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 hope 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?

Statbot's features of Statdocks (channel counters) and Statroles (Automatic Roles) can be a bit confusing for brand-new Statbot users. You can find links to those sections in the documentation below, but we suggest finishing this guide first so that you can more easily understand the settings.