Settings - 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.

Time

Settings that control time-related aspects of displaying stats.

info

These settings do NOT affect Statroles or Statdocks. Those features have their own time-based settings.

Lookback

Determines the default start time of stats shown on the dashboard and bot commands.

There are 3 modes:

• Days — Show stats this number of days back "now" (the time the dashboard loads or bot command is ran).
• Date — Show stats starting from a specific date.* Graphs and commands will be blank if this date is in the future.
• All — Show all of a server's stats.* (Equivalent to a very high Days; or Date set to before Statbot joined the server.)

Examples

• Days set to 10
  - On January 20th, stats will start from 10 days ago ( January 10th )
• Date set to January 1st, 2020
  - Stats will start from January 1st, 2020
• All - All the server's history will be displayed*

Note: Graphs may round to show full data points. Top tables and other stats will round by an hour at most.

tip

You can often dynamically change this initially loading stats via Dashboard Filters and Command Actions.

premium

The History Upgrade is required to access stats older than 30 days. When setting Date or All, stats will be limited to 30 days.

Interval (Precision)

The default "Interval" time setting for Dashboard Filters and commands. Can be set to Hour or Day.

Time Units

The default displayed time unit of Voice and Activity data for Dashboard Filters and commands. Can be set to Minutes, Hours, or Days.

Timezone

The timezone that the server's stats will show in. This affects all stats and is the only view-related option that cannot be changed dynamically.

info

Though this setting cannot be dynamically change like the others, changing it won't have any negative effect on stats.

Filters

Settings that control what data is shown based on lists of allowed or denied values.

Important

These settings are visual only. You can think of them as "hiding" data. They do not change the tracking behavior of the bot. They do not affect Statroles or Statdocks.

Activities

Control what Activities (games, applications) appear in stats on the dashboard and bot commands. This can help you view only Activities that your community is interested. Leave empty to include all activities.

Choose between Whitelist or Blacklist

• Whitelist — Only these activities will be included in graphs and commands.
• Blacklist — These activities won't be included in graphs and commands.

caution

You will need to have Activity Tracking turned on to track activities in your server.

Bots & Users

Which members will appear in stats on the dashboard and bot commands.

• Users — Human users.
• Bots — Non-human users.

Channels

Control what channels appear in stats on the dashboard and bot commands. Deleted channels will retain the category they were last in unless manually changed. Leave empty to include all channels.

Choose between Whitelist or Blacklist

• Whitelist — Only these channels will be included in graphs and commands.
• Blacklist — These channels won't be included in graphs and commands. (Will use all others.)

Member Blacklist

Remove members from dashboard and bot commands stats. Useful for filtering out spammers.

Leave empty to include all members.

premium

You can see individual member stats with the Drilldowns Upgrade!

Roles

Control what members appear in stats on the dashboard and bot commands based on roles they have.

Whitelist — Members must have at least one of the roles in this list.

Blacklist — Members must not have any of the roles in this list.

important

This setting retroactively changes stats as members are given and remove from roles. It also implicitly filters out members who are not in the server because there are no roles to check. Expect historic values to change.

Invites

Control what invites appear in stats on the dashboard and bot commands. This is useful for servers that want to focus on specific invite links. Leave empty to include all invites.

Choose between Whitelist or Blacklist

• Whitelist — Only these invites will be included in graphs and commands.
• Blacklist — These invites won't be included in graphs and commands.

Invite Fake Reasons

Configure which invite fake reasons to filter on. This allows you to track invites while filtering out those that are likely to be fake or spam accounts.

Choose between Whitelist or Blacklist

• Whitelist — Only invites that match the selected reasons will be included in graphs and commands.
• Blacklist — Invites that match the selected reasons won't be included in graphs and commands.

Additionally, set the Match Type to control how multiple reasons are handled:

• Any — An invite log needs at least one of the selected reasons to be considered a match.
• All — An invite log needs all of the selected reasons to be considered a match.

The available fake reasons are:

Reason	Description
Self	The invited member is the one who created the invite.
Already Joined	The invited member was already a member of the server.
New Account	The invited member's account age is below the configured minimum.
New Member	The invited member's server join age is below the configured minimum.
No Avatar	The invited member has no avatar set.
Require Role	The invited member does not have the required role(s).
Require Onboarding	The invited member has not finished the server's onboarding.
Require Home Actions	The invited member has not finished the server's home actions.
Pending	The invited member's guild member object has pending status.
Member Left	The invited member is no longer a member of the server.
Temporary	The invite grants temporary membership.

Voice States

Voice states that will appear in stats on the dashboard and bot commands.

• AFK — Member is in the AFK channel set in the server's Discord settings.
• Server-Deaf — Member has been deafened by someone with the Deafen Members Discord permission.
• Self-Deaf — Member has deafened themselves.
• Server-Mute — Member has been muted by someone with the Mute Members Discord permission.
• Self-Mute — Member has muted themselves.
• Normal — None of the above.

info

Only one state will be assigned to a member's voice activity even if they are multiple. The order of the list above is the order of priority the bot uses when logging.

Example: A member who is both AFK and Self-Mute will be logged as AFK.

caution

A member without a functioning mic will have the same symbol as someone who is muted (crossed-off microphone). This does NOT count as being Self-Mute or Server-Mute. Muted only occurs when the actual setting in Discord is used.

Tracking

Settings that control the tracking of the bot.

tip

If you don't want the bot to track specific channels, deny the bot the View Channel Discord permission on those channels.

Also make sure that the bot doesn't have Administrator.

Activity Tracking

premium

The Data+ Upgrade is required to use this setting.

Control if the bot is tracking activities (games, applications, etc.) for this server. When enabled, Statbot will track all the Activities in the list shown on the Dashboard.

If you don't see the activity you want in the list, run the /info activity command on a member while they are interacting with that activity, copy the output, and paste it in the #🎮-activity-requests channel in the Statbot support server.

Invite Tracking

Invite Tracking settings configure how the bot detects and flags fake or spam invites. These settings are found in the Invite Tracking section on the Stats settings page.

Required Account Age

The minimum account age (in minutes) required for an invite to not be marked as a New Account. Only applies at the time of joining. Set to 0 to disable.

Required Join Age

The minimum server join age (in minutes) required for an invite to no longer be considered a New Member. This updates dynamically as members age in the server. Members who leave and rejoin will need to meet this requirement again. Set to 0 to disable.

Required Roles

The role(s) a member must have to be marked as having the required roles. This updates dynamically as members gain roles. Role removal will not affect members who have already met this requirement. Members who leave and rejoin will need to meet this requirement again. Leave empty to disable.

Set the Match Type to control how multiple roles are handled:

• Any — A member needs at least one of the selected roles to meet this requirement.
• All — A member needs all of the selected roles to meet this requirement.

Invite Labels

Custom labels help you identify which invites are being used in your server stats. Labels only affect the visual representation of the invite in Statbot and do not affect how invites are tracked or displayed in Discord. This is especially useful for servers that wish to organize their invites with meaningful names.

You can set, edit, and delete labels from the Invite Labels card on the Stats settings page.

Verify Activities

Validate activities whenever possible. Prevents users from spoofing via renaming applications, though can sometimes cause problems when users are using unofficial or unsupported clients.

This setting affects Activity Tracking and Statroles with Activity Conditions.

caution

Only activities that Discord has assigned an ID can be validated in this way. Take care when assigning Statroles or using other features with these activities.

Data Management

Data Management is an advanced topic that you can read about here.