General

What is Statbot?

Statbot is a data collecting Discord bot that tracks: messages sent, minutes in voice, minutes of activities, member count of server, and online status of members over time. It displays all this information in various ways to help servers visualize trends and determine the activity of the server from overall performance to individual member and channel engagement. The Discord Bot has many different commands to view information from the comfort of your own server. The Web Dashboard provides a simple, single pane of glass that you can see even more stats on.

What is Statbot’s Invite?

What data does Statbot record?

Statbot only tracks amounts. This means number of messages, number of minutes in a voice channel, number of minutes spent on a certain activity, number of members, and number of online, dnd, and idle members.

Please note: All data that Statbot gathers and usage thereof is within Discords ToS and complies with the GDPR.

Does Statbot delete data?

Statbot never deletes data. All your data is stored in our database forever unless you request it removed. Free users can only view data up to 30 days back and if you wish to view further back you need to get the Historical premium perk.

How do I reset data/stats?

We do not currently offer a way for users to delete server stats. We try our best to offer other solutions since deleting stats can be a one-way street which people may regret in the future. Giveaways and the like can often be accomplished with the Timerange setting or Statroles. If you are a user that wants to delete/privatize their stats, you can do so through the website. If you have privacy concerns regarding your servers’ data, please reach out to us in our Support Server.

When will feature x or y be finished?

It is difficult for us to give ETA’s on features as this is not a full-time job of any of the team members. Feel free to refer to our Development Trello Board for information on what’s in the pipeline and to request what you don’t already see there.

What other features can we look forward to in the near future?

The Statbot team is continuously working on both creating new features and enhancing existing ones. You can look forward to the many new and exciting projects on our Trello Board.

How do I find my Server/User/Channel ID?

First make sure you have Developer Mode enabled on your Discord by visiting your Discord settings and going to Appearance.

  • To get your Server ID right click on the server icon on the left hand sidebar then click on “Copy ID” then paste it into your Discord or on a text editor.
  • To get your User ID or anyone else’s User ID right click on their name and click “Copy ID” then paste it into your Discord or on a text editor. Alternative type there name as a mention and place a backslash \ in front of the mention. It should look like this <@!357240408373198868> and the numbers are the ID.
  • To get a Channel ID right click the channel and click on “Copy ID” then paste it into your Discord or on a text editor. Alternatively type the channel as a mention and place a backslash \ in front of the mention. It should look like this <#475182341782896651> and the number is the ID.

For more info on the different ID’s visit this link https://support.discordapp.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID-

How do I make my user stats private?

To make your user stats private, log into the site ( https://statbot.net ) then click on your name in the top-right corner and click on “Privacy”.

Note: You can only perform this action once every 24h and the process takes a bit of time. Once it is completed you will have a notification on the site informing you there of.

Warning: By anonymizing your data, Statbot may not be able to accurately determine your activity in a server when executing services like Smart Prune and Statroles. Anonymizing your data may result in decreased user experience.

Users anonymizing their data have no affect on a server’s overall stats.

Bot

What permissions does the bot need?

It needs all permissions in the invite, excluding Administrator and Manage Server.

  • Administrator: Track all channels and bypass all blocks by default, feel free to turn this off. Note if you do turn this off it will no longer track channels that are role-locked. Ensure you have added Statbot to any role-locked channels you want tracked. Remember that once Administrator is removed you should enabled the ability to send Embed Links and Attach Files in order to use many of Statbot’s commands.

I just added the bot and I don’t see any stats.

The bot only starts tracking from the moment it gets added to your server. It also take up to a few minutes to process new events.

The bot does not reply.

Please ensure that the bot has the Read Message and Send Messages permission for the channel you are using commands in. Also remember that the bot requires Embed Links to send embeds which it does for most commands and Attach Files to send any graph-related commands.

How do I set the prefix?

To set your prefix type s?set prefix [new prefix]

To set it back to default just use s?set prefix

If you ever need to find your prefix, run @Statbot prefix

How do I change the amount of days I can see back?

To change your Timerange, which determines how far back commands will look when you run them, simply type s?set timerange [# days]
A free server you can see up to 30 days back and can only view day-by-day data. With the History Perk, you can view back as far as we have data available for your server. With our Precision Perk, you can view down to the hour in data by typing s?set precision hour
You can also perform these actions on the website on the Manage page of your server.

How do I limit commands to Admin only?

To limit your server to Admin only you can type “s?toggle admin”.
You can also find this option on the website on the “Manage” page of your server.

Why are my stats going up/down on different days without me doing anything?

When you use the commands to view stats, they are periodical and are determined by the Timerange setting of the server which is the number of days back from the command that the stat shown are from. This is set by an Administrator of the server. For example, if you were to run the command “s?me” today, it will show different information than doing it in a week from now, because these are two different periods of time. For free servers, the period can be anything from 1 day back to 30 days back, and back to when Statbot was added for servers with the History perk. You should always remember that your stats will never be the same if checked on different days through commands. They can either increase or decrease depending on how active you have been and if the Timerange has been changed between when the commands are ran.

<Note: This applies to all server stats viewed through commands.>

How do I stop Statbot from sending messages in certain channels?

You first have to remove the Administrator permission of Statbot in your Server Settings > Roles tab. Then add Statbot’s or user to each channel’s permissions that don’t want it to send messages in. This can be found in the Channel Settings > Permissions tab. The Send Messages and Read Permissions are what you’re interested in. Deny it the Send Messages permissions. Then make sure that it can still read the channels you want which may involve giving it the Read Messages permission on those channels. Any channels that are locked behind a role you have to also add Statbot to if you want it to be tracked.

How do I exclude certain channels from being tracked?

If you want to permanently prevent tracking, remove Administrator from Statbot if it has it and deny Statbot the ability to Read Messages in the channels you don’t want tracked. If you want the channels tracked by not displayed in Non-Drilldown (the premium perks) settings, get the channel name or ID then use the command s?exclude [#channel or ID or channel name] . You can also included this channel back into stats in the future by use the command s?include [#channel or ID or channel name]

Website

Where is my user page?

As the focus of Discord communities is the community itself, we have left out user pages for the launch of v2. User pages were also a privacy concern in the past and so it was necessary to go back to the drawing board if we were going to re-implement them. With the Member Drilldown perk, the owner and admins of the servers can pull the server-specific stats of a particular member.

What time range are the stats on the site based on?

The period you set your server to will determine what data the site displays for that server. For example, if you set your period to 7 days, the site will display 7 days worth of data from the time the page loads. With the History Perk, you can view back as far as we have data available for your server. With our Precision Perk you can view down to the hour in data and view the heatmaps on each of the Message, Voice, and Presence tabs.

Can I set my server to private?

By default your server will be set to public meaning that anybody can view the website dashboard. If you head over to your “Manage” page for the server, you can set your server to private by turning “Public” off.

You can also do this through the Discord command s?toggle public

How do I get to my server’s settings on the site?

To configure your server via the site, simply log in, then click on the server you would like to configure. This will take you to your server’s dashboard. At the top of this area there will be multiple tabs. Click on the “Manage” tab to view and change the settings of your server.

I want my mods to have access to the Dashboard while it is private.

To do this you need to use the command s?permission add dashboard followed by the permission. So long as the user has a role with the permission you specify in this command, they will be able to view the dashboard when the “Public” setting is off.

Available Permissions

  • Manage Channels
  • Manage Guild
  • View Audit Log
  • Manage Messages
  • Mute Members
  • Deafen Members
  • Move Members
  • Manage Roles

 

To remove the permission use s?permission remove dashboard followed by the permission name.

Perks

Why does Statbot have premium?

Statbot is an elegant product that brings you powerful, informative data about your server. We pride ourselves on quality and consistency, but doing so requires demanding resources. Server costs for Statbot exceed that of your average bot of its size. To ensure that each server is given the best possible experience with high availability and up-time, we offer premium functionality to cover the ever-increasing costs. In return for upgrading to one of our premium tiers, you will unlock extra features.

What is the Precision perk?

The Precision perk allows a server to get statistics down to the hour and grants access to the heatmaps on the Message, Voice, and Presence tabs. Without this perk, a server will only be able to view daily data and will not be able to view the heatmaps.

What is the History perk?

The History perk will allow a server to view back as far as we have data for the server. This means you can set your server to your desired time range and your data will display to either the first recorded data point or the start point of your set Timerange, whichever comes first. Without this, a server will only be able to view a maximum of 30 days of data.

What is the Member Drilldown perk?

The Member Drilldown perk will allow the server owner and admins to run reports based on a user ID. Once you enter the user ID in the search box, you will be presented with total channel message count, and voice counts separated by AFK, self-mute, self-deaf, server-mute, and server-deaf. You will also get to fine tune your results by specifying a date range (start and end) and filtering out channels. If you only want to see a days worth of data then no problem! Just select that day and only that data is presented. If you want to remove certain channels from the stats then simply filter them out. Additionally, if you have the History Perk you can view more than 30 days back; and if you have the Precision Perk, you can view hourly data (set through your Manage page or through the bot). You can learn more about the Drilldowns by watching this video.

What is the Channel Drilldown perk?

Channel Drilldown will allow the server owner and admins to run reports based on a channel ID. Once you enter the channel ID in the search box, you will be presented with total member message counts for text, and voice counts for voice. With this perk, you will also get to fine tune your results by specifying a date range (start and end) and filtering out users. If you only want to see a days worth of data, then no problem! Just select that day and only that data is presented. If you only want to see how your staff is performing, then simply switch to whitelist and set the filter to only those users. Additionally, if you have the History Perk you can view more than 30 days back; and if you have the Precision Perk, you can view hourly data (set through your Manage page or through the bot). You can learn more about the Drilldowns by watching this video.

I want my mods to have access to the Drilldown tabs

To do this you need to use the command s?permission add drilldown followed by the permission. So long as the user has a role with the permission you specify in this command, they will be able use the Drilldown tabs. This will also give them permission to view the rest of the Dashboard even if it’s not public.

Available Permissions

  • Manage Channels
  • Manage Guild
  • View Audit Log
  • Manage Messages
  • Mute Members
  • Deafen Members
  • Move Members
  • Manage Roles

 

To remove the permission use s?permission remove drilldown followed by the permission name.

Where is the API?

We have decided to completely re-work the API in v2. We will not have it available right away; however, this is on the list to get completed so that we can offer the feature to you again.

How do I cancel my subscription?

You can do so at any time through PayPal.