# Welcome Welcome to VoiceStats documentation. ## Introduction Track voice and message activity with VoiceStats. View detailed statistics and rankings across the complete history VoiceStats has recorded, plus charts for recent activity. {% hint style="success" %} **All-time access is free.** Stats cards and voice, channel, and message leaderboards can show the complete history VoiceStats has recorded for your server. Charts do not include an all-time view; custom 1–30 day periods require Premium. {% endhint %} ## Features VoiceStats offers many features including: * Voice and message statistics for members and servers * User, server, channel, and member activity charts * Voice, channel, and message rankings * Shared bot, member, and channel filters * Auto-updating voice and message leaderboard panels * Private or publicly shared Web Leaderboards for voice and message rankings * Personal Web Leaderboard card colors * Preset backgrounds for generated stats, rankings, and charts * A customizable server-specific Bot Profile * Voice-time and message-count Role Rewards * Giveaways with role, voice-time, and message-count requirements * Server settings and module management from the Dashboard You can check the [commands](/general/commands) page to see more features. ## Setup You can add VoiceStats to your server by clicking [here](https://voicestats.xyz/invite). For more help, click [here](/getting-started/setup). VoiceStats only asks for permissions required for operation by default, we recommend making sure you invite VoiceStats with the necessary permissions. Otherwise, the bot may not work properly. # Setup Follow these steps to add VoiceStats to your server. {% stepper %} {% step %} #### Click [**here**](https://voicestats.xyz/invite) to access the VoiceStats server invitation screen. {% endstep %} {% step %} #### After seeing a screen like the one above, select the server where you want to add VoiceStats and use the continue button. {% endstep %} {% step %} #### Then, VoiceStats will only ask for the permissions required for operation by default. We recommend making sure you invite VoiceStats with the necessary permissions. Otherwise, the bot may not work properly. | Permission | Usage | | -------------------- | ------------------------------------------------- | | View Channel | Required to view voice channels. | | Send Messages | Required to respond to commands. | | Embed Links | Required to send embeds. | | Attach Files | Required to send statistic images and charts. | | Read Message History | Required to view and edit older messages. | | Use External Emojis | Required for VoiceStats to use its custom emojis. | | {% endstep %} | | {% step %} #### Then use the authorize button. {% endstep %} {% step %} #### Successfully added the bot. {% endstep %} {% endstepper %} {% hint style="success" %} You have successfully added the bot to the server! Now try running your first command. {% endhint %} #### **Try Your First Command!** You have successfully added VoiceStats to your server, great! To test that everything is working smoothly and to see your own data, spend at least 30 seconds in a voice channel, and then type `/my stats` in any text channel. If you want to explore all the other features the bot offers, the `/help` command will guide you. Now VoiceStats has been added to your server. You can enjoy using VoiceStats on your server with the / prefix.. # FAQ Frequently asked questions about VoiceStats. ## Can I view all-time statistics for free? Yes. Every server can view the complete history VoiceStats has recorded in stats cards and voice, channel, and message leaderboards. Premium is not required. Charts do not offer an all-time view. Free servers can use the standard chart periods, while custom 1–30 day periods require Premium. ## Why isn't VoiceStats counting my voice time? There may be a few reasons why your voice time is not being recorded. Please check the following situations: ### 1. Minumum 30 seconds Make sure you have spent at least **30 seconds** in a voice channel. ### 2. The member or channel might have been added to the filters. The member or channel might have been added to the filters. If added, voice time will not be recorded. Use the `/settings` command or the web [Dashboard](https://voicestats.xyz/dashboard) to check your filters. ### 3. It might be an AFK channel Time spent in the inactive (AFK) channel set in your server settings is not counted by VoiceStats. To verify this, go to the "Engagement" section in your server settings, scroll down, and look for "Inactive Channel." If your users are in the AFK channel set here, their time won't be counted. ## Which permissions does VoiceStats require? | Permission | Usage | | -------------------- | ------------------------------------------------- | | View Channel | Required to view voice channels. | | Send Messages | Required to respond to commands. | | Embed Links | Required to send embeds. | | Attach Files | Required to send statistic images and charts. | | Read Message History | Required to view and edit older messages. | | Use External Emojis | Required for VoiceStats to use its custom emojis. | Some modules need additional permissions only when you enable their related features: | Feature | Additional requirement | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Role Rewards | **Manage Roles**. VoiceStats' highest role must also be above every reward role. | | Giveaway winner role | **Manage Roles** is required only when a winner role is selected. VoiceStats' role must be above that role. | | Pin Leaderboard | In the selected channel, VoiceStats needs **View Channel**, **Send Messages**, **Attach Files**, and **Read Message History** so it can publish and update the panel. It does not pin the Discord message. | | Role Reward announcements | VoiceStats needs **View Channel** and **Send Messages** in the selected announcement channel. | Server owners and members with **Administrator** permission can open a server in the Dashboard. Giveaway commands and the **End Giveaway** / **Reroll Giveaway** message actions are also Administrator-only. If VoiceStats is not working as expected, a server administrator can run `/debug` in the affected channel to check the bot's effective permissions and server diagnostics. ## Can I change the time unit or time zone displayed in the statistics? Yes, you can change the displayed **time unit** and the **Time Zone** from the `/settings` command or via the web [Dashboard](https://voicestats.xyz/dashboard). ## Can I filter a member or a channel? Yes, you can add a **member** or a **channel** to the filters from the `/settings` command or the [Dashboard](https://voicestats.xyz/dashboard). ## How can I change the bot's language? VoiceStats automatically syncs with your Discord client's language settings. There is no specific command to change the language; simply change your language in your personal Discord user settings, and the bot will respond in that language. ## Does time spent in the server's AFK channels count? Time spent in the inactive (AFK) channel set in your server settings is **not counted** by VoiceStats. ## What is VoiceStats default prefix? VoiceStats' default prefix is: / ## How to Copy IDs? When using VoiceStats filters or commands, you may need the ID of a specific user, channel, or message. To copy any ID in Discord, you first need to enable **Developer Mode**. ### Enabling Developer Mode This mode allows you to use Discord's advanced features and can be enabled in seconds. #### **On Desktop and Web:** 1. Click the gear icon in the bottom left corner to open **User Settings**. 2. Scroll down the left menu and click on the **Advanced** tab. 3. Toggle the **Developer Mode** switch at the top to the on (green) position.
#### **On Mobile Devices (iOS/Android):** 1. Tap your profile in the bottom right corner and enter **Settings** via the gear icon in the top right. 2. Scroll down to find and tap on the **Advanced** option. 3. Toggle **Developer Mode** on. ### Copying IDs Once Developer Mode is enabled, copying an ID is very simple: #### **πŸ‘€ Copy User ID** Right-click on the user's name or profile picture in the chat or member list (tap and hold on mobile). Click on the **Copy User ID** option at the very bottom of the menu.
#### **πŸ”Š Copy Channel ID** Right-click on the name of the channel in the server channel list on the left (tap and hold on mobile). Click on the **Copy Channel ID** option at the bottom.
#### 🏰 Copy Server ID Right-click on the server icon in the server list on the left (tap and hold on mobile). Click on the Copy Server ID option at the very bottom of the menu. #### **πŸ’¬ Copy Message ID** Hover over any message in the chat and click the three dots `...` that appear on the right (or right-click the message). Select the **Copy Message ID** option at the very bottom of the menu.
## VoiceStats commands are not visible/usable? If the slash commands are not visible on a server where you added VoiceStats, you might not have added the bot correctly. Please check the following steps in order: ### 1. Re-invite the Bot Try re-inviting the bot to your server: [Invite Bot](https://voicestats.xyz/invite). This can refresh any command registrations that might have been missed during the initial setup. ### 2. Check the 50 Bots Limit If you still cannot see the slash commands, ensure your server does not have more than 50 bots. Discord supports slash commands for up to 50 bots. If this limit is exceeded, commands for some bots may fail to appear. ### 3. Review Role Permissions If users on your server cannot see or use the bot's slash commands, ensure the Use Application Commands permission is enabled in their roles. Without this permission, regular members cannot interact with slash commands.
### 4. Verify Integration Settings If users on your server still cannot see or use the bot's slash commands, go to the server settings under the Integrations section, select VoiceStats, and make sure the `@everyone` and `#All Channels` settings are enabled
## How can I add VoiceStats to my server? Click [here](https://voicestats.xyz/invite) to invite VoiceStats to your server. For more help, click [here](/getting-started/setup). {% embed url="" %} ## Where can I vote for VoiceStats? Click [here](https://voicestats.xyz/vote) to vote for VoiceStats. {% embed url="" %} ## How can I open the VoiceStats Dashboard? Open the [VoiceStats Dashboard](https://voicestats.xyz/dashboard) and sign in with Discord. Select a server you own or where you have **Administrator** permission to view its statistics, settings, filters, and modules. You can also run `/dashboard` in Discord to get the Dashboard link. ## Server Stats and Server Chart Statistics Are Not the Same For example, in the `/server stats` command, 10 unique users may appear over the last 30 days, while in the `/server chart` command, only 7 unique users may be shown. The reason for this is that the chart does not sum up all unique users during that time period; instead, it shows the number of unique users separately for each time interval on the chart. In the given example, if those 10 unique users were not in voice channels during the same time interval and at most 7 unique users were active at any given time, this discrepancy occurs. Therefore, this is not a bug. ## My question isn't here, what can I do? If your question isn't here, you can join our [support server](https://voicestats.xyz/support) and ask in the help channel. {% embed url="" %} # Commands All commands, descriptions, and usages of VoiceStats are as follows. ## General Commands related to the core functions, configuration settings, and general information links for the VoiceStats bot. | Command | Description | Usage | | ------------------ | ------------------------------------------------------------------------------- | ------------------ | | `/help` | Learn about VoiceStats and its features. | `/help` | | `/settings` | Configure VoiceStats's settings. | `/settings` | | `/premium` | Learn more about [premium](https://voicestats.xyz/premium) membership. | `/premium` | | `/dashboard` | View the link to the VoiceStats [dashboard](https://voicestats.xyz/dashboard). | `/dashboard` | | `/role rewards` | Learn about Role Rewards and view this server's rewards. | `/role rewards` | | `/pin leaderboard` | Learn about pinned voice and message leaderboards on this server. | `/pin leaderboard` | | `/invite` | [Invite](https://voicestats.xyz/invite) VoiceStats to your server. | `/invite` | | `/support` | View the link to VoiceStats's [support server](https://voicestats.xyz/support). | `/support` | | `/ping` | Displays VoiceStats's ping values. | `/ping` | | `/vote` | View the voting link and check your next available vote time. | `/vote` | ## **User Commands** Commands that allow you to view individual voice chat statistics and charts for yourself or other members in the server. | Command | Description | Usage | | ---------------- | --------------------------------------------- | ----------------------- | | `/my stats` | View your voice statistics. | `/my stats` | | `/my chart` | View your voice statistics as a chart. | `/my chart` | | `/user stats` | View the voice statistics of a specific user. | `/user stats [user]` | | `/user chart` | View a user's voice statistics | `/user chart [user]` | | `/message stats` | View a member's message statistics. | `/message stats [user]` | | `/message chart` | View a member's message activity chart. | `/message chart [user]` | ## **Server Commands** Commands that display server-wide voice chat rankings and the overall statistics of the community. | Command | Description | Usage | | ----------------------- | ----------------------------------------- | ----------------------- | | `/voice ranking` | View the server's user voice rankings. | `/voice ranking` | | `/server stats` | View the server's voice statistics. | `/server stats` | | `/server chart` | View the server's voice statistics | `/server chart` | | `/message ranking` | View the server's message ranking. | `/message ranking` | | `/message server stats` | View the server's message statistics. | `/message server stats` | | `/message server chart` | View the server's message activity chart. | `/message server chart` | ## **Channel Commands** Commands that focus directly on specific voice channels, listing their internal statistics and rankings. | Command | Description | Usage | | ------------------ | ------------------------------------------------ | -------------------------- | | `/channel stats` | View the voice statistics of a specific channel. | `/channel stats [channel]` | | `/channel chart` | View the voice activity chart of a channel. | `/channel chart [channel]` | | `/channel ranking` | View the server's channel voice rankings. | `/channel ranking` | ## **Admin Commands** Configuration commands available only to authorized administrators, such as resetting or exporting statistics, and managing custom filters. | Command | Description | Usage | | -------------------------- | --------------------------------------------------------------------- | ----------------------------------- | | `/debug` | Check VoiceStats permissions, Premium status, and server diagnostics. | `/debug` | | `/reset user stats` | Reset a user's voice and message statistics. | `/reset user stats [user]` | | `/reset server stats` | Resets voice and message statistics in this server. | `/reset server stats` | | πŸ’Ž `/export voice ranking` | Export the voice ranking as a .csv file. | `/export voice ranking [period]` | | `/filter channels add` | Adds a voice channel to the filter. | `/filter channels add [channel]` | | `/filter channels remove` | Removes a voice channel from the filter. | `/filter channels remove [channel]` | | `/filter members add` | Adds a member to the filter. | `/filter members add [user]` | | `/filter members remove` | Removes a member from the filter. | `/filter members remove [user]` | | `/filter roles add` | Adds a role to the filter. | `/filter roles add [role]` | | `/filter roles remove` | Removes a role from the filter. | `/filter roles remove [role]` | {% hint style="info" %} **πŸ’Ž Note:** Commands with a diamond emoji next to them are exclusive to Premium servers. {% endhint %} # General Commands related to the core functions, configuration settings, and general information links for the VoiceStats bot. With these commands, you can configure the bot for your server, access the management panel, and reach our support channels. ### /help * **Description:** Learn about VoiceStats and its features. It provides a quick guide on how the bot works. * **Usage:** `/help` ### /settings * **Description:** Configure VoiceStats's settings. You can manage filters and time unit formats through this command. * **Usage:** `/settings` ### /premium * **Description:** Learn more about premium membership and its exclusive perks. * **Usage:** `/premium` ### /dashboard * **Description:** View the link to the VoiceStats dashboard. This allows you to easily manage your server settings via the web interface. * **Usage:** `/dashboard` ### /role rewards * **Description:** Learn how Role Rewards works and view the voice and message rewards currently configured for this server. Server administrators receive a direct link to the module's Dashboard page. * **Usage:** `/role rewards` ### /pin leaderboard * **Description:** Learn how Pin Leaderboard works and view the active pinned voice and message rankings in this server. Server administrators receive a direct link to the module's Dashboard page. * **Usage:** `/pin leaderboard` ### /invite * **Description:** Invite VoiceStats to your server or any other server where you have the required permissions. * **Usage:** `/invite` ### /support * **Description:** View the link to VoiceStats's support server. Use this if you encounter any issues or need assistance. * **Usage:** `/support` ### /ping * **Description:** Displays VoiceStats's ping values in milliseconds. * **Usage:** `/ping` ### /vote * **Description:** Displays the VoiceStats voting link and shows how long until you can vote again. After voting, the bot sends you a DM reminder when your next vote is available. You can toggle these reminders on or off directly from the command. * **Usage:** `/vote` # Giveaway Commands Create and manage VoiceStats giveaways with Discord commands. Server owners and members with **Administrator** permission can create and manage giveaways with the `/giveaway` command. | Command | Description | Basic usage | | --------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------- | | `/giveaway create` | Create a giveaway and post it in a channel. | `/giveaway create [prize] [winners] [duration]` | | `/giveaway edit` | Change the prize, winner count, winner role, or remaining duration of an active giveaway. | `/giveaway edit [message_id]` | | `/giveaway end` | End an active giveaway immediately and select its winners. | `/giveaway end [message_id]` | | `/giveaway reroll` | Select new winners for an ended giveaway. | `/giveaway reroll [message_id]` | | `/giveaway delete` | Permanently delete an active giveaway. | `/giveaway delete [message_id]` | | `/giveaway list` | View the giveaways created in the server. | `/giveaway list` | | `/giveaway templates` | View the server's saved giveaway templates. Templates are managed from the Dashboard. | `/giveaway templates` | | `/giveaway scheduled` | View the server's scheduled giveaways. Schedules are managed from the Dashboard. | `/giveaway scheduled` | Discord displays optional choices for role rules, total voice time, and total message count while you fill out the create command. Templates and scheduled giveaways can be viewed from Discord, but they can only be created, edited, or deleted in the Dashboard. For a full explanation of entry rules, editing, rerolls, templates, schedules, and limits, see the [Dashboard Giveaway guide](/dashboard/giveaways). You can also right-click a giveaway message and choose **Apps β†’ End Giveaway** or **Apps β†’ Reroll Giveaway**. These Administrator-only shortcuts use the normal settings automatically: reroll selects the giveaway's configured winner count and excludes the previous winners. # User Commands Commands that allow you to view individual voice chat statistics and charts for yourself or other members in the server. ### /user stats and /my stats View your voice statistics or the voice statistics of a specific user. The statistics card includes information such as total time, activity in the last 30 days, and the most active channels. | Command | Description | Usage | Example Usage | | ------------- | --------------------------------------------- | -------------------- | ------------------------ | | `/user stats` | View the voice statistics of a specific user. | `/user stats [user]` | `/user stats user:@sytx` | | `/my stats` | View your voice statistics. | `/my stats` | `/my stats` |
### /user chart and /my chart These commands display your voice statistics or a specific user's voice statistics as a chart based on the selected period. This allows you to examine the fluctuations in daily voice activity on a visual chart. | Command | Description | Usage | Example Usage | | ------------- | -------------------------------------- | -------------------- | ------------------------ | | `/user chart` | View a user's voice statistics. | `/user chart [user]` | `/user chart user:@sytx` | | `/my chart` | View your voice statistics as a chart. | `/my chart` | `/my chart` |
### /message stats and /message chart `/message stats` shows a member's total and recent message activity, server rank, and most active days. `/message chart` displays that member's counted messages over the selected period. The optional `user` choice lets you view another member. | Command | Description | Usage | | ---------------- | --------------------------------------- | ----------------------- | | `/message stats` | View a member's message statistics. | `/message stats [user]` | | `/message chart` | View a member's message activity chart. | `/message chart [user]` |
Using the buttons located below the command output, data can be filtered and different time periods (Last 1 Days, Last 14 Days, Last 30 Days, Custom Period) can be selected.
{% hint style="success" %} All-time totals in user and message stats are free. Chart commands do not offer an all-time view. {% endhint %} {% hint style="info" %} **πŸ’Ž Info:** The Custom Period filtering feature is exclusive to Premium servers. {% endhint %} # Server Commands Commands that display server-wide voice chat rankings and the overall statistics of the community. ### /voice ranking Displays the server's user voice rankings (leaderboard) based on the time spent in voice channels. Using the buttons located in the command output, you can navigate between pages and filter ranking data by different time periods (Last 1 Days, Last 14 Days, etc.) via the "Period" button. | Command | Description | Usage | Example Usage | | ---------------- | -------------------------------------- | ---------------- | ---------------- | | `/voice ranking` | View the server's user voice rankings. | `/voice ranking` | `/voice ranking` |
### /message ranking Displays the server's member ranking by counted messages. The period and pagination controls work like the voice ranking. | Command | Description | Usage | | ------------------ | ---------------------------------- | ------------------ | | `/message ranking` | View the server's message ranking. | `/message ranking` |
### /server stats Displays the server's overall and unique voice statistics (all-time, last 30 days, last 14 days, etc.) on a single information card. This card includes active voice users and total unique user counts. | Command | Description | Usage | Example Usage | | --------------- | ----------------------------------- | --------------- | --------------- | | `/server stats` | View the server's voice statistics. | `/server stats` | `/server stats` |
### /server chart Displays the server's overall voice activity and user density as a chart. Data fluctuations over different time ranges can be visualized using the "Period" button. | Command | Description | Usage | Example Usage | | --------------- | ---------------------------------------------- | --------------- | --------------- | | `/server chart` | View the server's voice statistics as a chart. | `/server chart` | `/server chart` |
### /message server stats Displays the server's counted messages and unique message senders for all time and the last 30, 14, 7, and 1 days. | Command | Description | Usage | | ----------------------- | ------------------------------------- | ----------------------- | | `/message server stats` | View the server's message statistics. | `/message server stats` |
### /message server chart Displays the server's counted message activity and unique senders over the selected period. | Command | Description | Usage | | ----------------------- | ----------------------------------------- | ----------------------- | | `/message server chart` | View the server's message activity chart. | `/message server chart` |
Using the buttons located below the command output, data can be filtered and different time periods (Last 1 Days, Last 14 Days, etc.) can be selected.
{% hint style="success" %} All-time views in voice and message rankings and server stats are free. Chart commands do not offer an all-time view. {% endhint %} {% hint style="info" %} **πŸ’Ž Info:** The Custom Period filtering feature is exclusive to Premium servers. {% endhint %} # Channel Commands Commands that focus directly on specific voice channels, listing their internal statistics, charts, and rankings. ### /channel ranking Displays the overall channel leaderboard, ranking the server's voice channels based on their usage duration. Using the buttons located in the command output, you can navigate between pages and filter ranking data by different time periods (Last 1 Days, Last 14 Days, etc.) via the "Period" button. | Command | Description | Usage | Example Usage | | ------------------ | ----------------------------------------- | ------------------ | ------------------ | | `/channel ranking` | View the server's channel voice rankings. | `/channel ranking` | `/channel ranking` |
### /channel stats Displays detailed statistics of a specific voice channel and the most active users who spend time in it on a single information card. | Command | Description | Usage | Example Usage | | ---------------- | ----------------------------------------- | -------------------------- | ----------------------------------- | | `/channel stats` | View the server's channel voice rankings. | `/channel stats [channel]` | `/channel stats channel:#"General"` |
### /channel chart Displays the voice activity of a specific voice channel over time as a chart. Shows the total voice duration alongside the number of unique users in each time interval. Data fluctuations over different time ranges can be visualized using the "Period" button. | Command | Description | Usage | Example Usage | | ---------------- | ------------------------------------------- | -------------------------- | ----------------------------------- | | `/channel chart` | View the voice activity chart of a channel. | `/channel chart [channel]` | `/channel chart channel:#"General"` |
Using the buttons located below the command output, data can be filtered and different time periods (Last 1 Days, Last 14 Days, etc.) can be selected.
{% hint style="success" %} All-time channel stats and rankings are free. Channel charts do not offer an all-time view. {% endhint %} {% hint style="info" %} **πŸ’Ž Info:** The Custom Period filtering feature is exclusive to Premium servers. {% endhint %} # Admin Commands Configuration commands available only to authorized administrators, such as resetting or exporting statistics, and managing custom filters. ### Reset Statistics Commands These commands allow you to permanently reset the voice and message statistics of a specific user or the entire server. Please use these commands with caution. | Command | Description | Usage | Example Usage | | --------------------- | --------------------------------------------------- | -------------------------- | ------------------------------ | | `/reset user stats` | Reset a user's voice and message statistics. | `/reset user stats [user]` | `/reset user stats user:@sytx` | | `/reset server stats` | Resets voice and message statistics in this server. | `/reset server stats` | `/reset server stats` | ### Export Command Converts the server's voice ranking data into an Excel (.csv) file so you can download and analyze it. | Command | Description | Usage | Example Usage | | -------------------------- | ---------------------------------------- | -------------------------------- | --------------------------------- | | πŸ’Ž `/export voice ranking` | Export the voice ranking as a .csv file. | `/export voice ranking [period]` | `/export voice ranking period:30` | ### Channel Filters Used to exclude specific channels from new statistical activity. Voice time or messages recorded before a channel is filtered are not deleted. | Command | Description | Usage | Example Usage | | ------------------------- | ---------------------------------- | ----------------------------------- | -------------------------------------------- | | `/filter channels add` | Adds a channel to the filter. | `/filter channels add [channel]` | `/filter channels add channel:#"General"` | | `/filter channels remove` | Removes a channel from the filter. | `/filter channels remove [channel]` | `/filter channels remove channel:#"General"` | ### Member Filters Prevents new voice and message activity from being recorded for selected server members. Existing statistics are not deleted. | Command | Description | Usage | Example Usage | | ------------------------ | --------------------------------- | ------------------------------- | ----------------------------------- | | `/filter members add` | Adds a member to the filter. | `/filter members add [user]` | `/filter members add user:@sytx` | | `/filter members remove` | Removes a member from the filter. | `/filter members remove [user]` | `/filter members remove user:@sytx` | ### Role Filters Prevents new voice and message activity from being recorded for members with selected roles. Existing statistics and ranking entries are not deleted. | Command | Description | Usage | Example Usage | | ---------------------- | ------------------------------- | ----------------------------- | ---------------------------------- | | `/filter roles add` | Adds a role to the filter. | `/filter roles add [role]` | `/filter roles add role:@Muted` | | `/filter roles remove` | Removes a role from the filter. | `/filter roles remove [role]` | `/filter roles remove role:@Muted` | ### Debug Command Checks VoiceStats' effective permissions in the current channel and shows useful server, user, and Premium diagnostics. Use this command in the channel where you are experiencing a problem. | Command | Description | Usage | Example Usage | | -------- | ------------------------------------------------ | -------- | ------------- | | `/debug` | Check VoiceStats permissions and server details. | `/debug` | `/debug` | {% hint style="info" %} Filter operations can also be performed via the [Dashboard](https://voicestats.xyz/). {% endhint %} {% hint style="info" %} **πŸ’Ž Note:** Commands with a diamond emoji next to them are exclusive to Premium servers. {% endhint %} # Context Menu Right-click shortcuts available in VoiceStats. Access user stats, charts, and admin tools directly from the Discord user context menu. VoiceStats registers user and message context-menu commands under **Apps**. They provide quick access to common actions without typing a slash command or copying an ID. ## Viewing Statistics ### User Stats Displays the voice statistics of the selected user β€” identical to running `/user stats [user]`. * **How to use:** Right-click a member β†’ Apps β†’ **User Stats** ### User Chart Displays the selected user's voice statistics as a chart β€” identical to running `/user chart [user]`. * **How to use:** Right-click a member β†’ Apps β†’ **User Chart** ## Admin Actions These context menu commands require the **Administrator** permission. ### Reset User Stats Permanently resets all voice and message statistics of the selected user in this server. A confirmation prompt will appear before the action is carried out. * **How to use:** Right-click a member β†’ Apps β†’ **Reset User Stats** {% hint style="warning" %} This action is irreversible. The user's entire voice and message statistics for this server will be deleted. {% endhint %} ### Toggle User Filter Quickly adds or removes the selected member from the server's member filter. If the user is already filtered, they will be removed from the filter; if they are not filtered, they will be added. * **How to use:** Right-click a member β†’ Apps β†’ **Toggle User Filter** {% hint style="info" %} This is a shortcut for the **Member Filter** setting. Filter operations can also be performed via the [Dashboard](https://voicestats.xyz/). {% endhint %} ## Giveaway Message Actions These actions require **Administrator** permission and appear when you right-click a message. ### End Giveaway Ends the selected active giveaway immediately and selects its configured number of winners. * **How to use:** Right-click a giveaway message β†’ Apps β†’ **End Giveaway** ### Reroll Giveaway Rerolls the selected ended giveaway using its configured winner count. Winners from the previous draw are excluded automatically. * **How to use:** Right-click an ended giveaway message β†’ Apps β†’ **Reroll Giveaway** # Settings Learn how to configure server settings for the VoiceStats Discord bot. Easily manage filters, language, visibility, periods, and display preferences. The `/settings` command opens the main menu where you can quickly configure server-specific VoiceStats preferences directly within Discord. Select a category from the dropdown menu to view or change it. The same settings are available from the [VoiceStats Dashboard](https://voicestats.xyz/dashboard). The Dashboard section of this documentation contains the detailed guides for each category. ## Filters #### [**Bot Filter**](/dashboard/bot-filter) Controls whether other bots are included in voice-time and message statistics. #### [**Member Filter**](/dashboard/member-filter) Allows you to exclude specific members from voice and message statistics tracking. #### [**Channel Filter**](/dashboard/channel-filter) Allows you to exclude specific voice or text channels from statistics tracking. #### [**Role Filter**](/dashboard/role-filter) Prevents new voice and message activity from being recorded for members with selected roles. ## General #### [**Server Language**](/dashboard/settings) Sets the shared language used by VoiceStats modules, including dashboard-created giveaways, Role Rewards, and Pin Leaderboard. #### [**Ranking Visibility**](/dashboard/visibility) Controls whether filtered members and channels are visually hidden from leaderboards and statistics displays. #### [**Deleted Channels**](/dashboard/visibility) Determines whether voice channels that have been deleted from Discord β€” but still have historical statistics β€” are shown in channel rankings and member channel breakdowns. ## Stats #### [**Time Units**](/dashboard/time-units) Allows you to adjust the time format (Full format, hours, days, etc.) displayed in the statistics to best suit your community. #### [**Time Zone**](/dashboard/timezone) Ensures that daily statistics and charts are synchronized with your server's local time zone. #### [**Stats Period**](/dashboard/periods) Allows you to define the default time range (e.g., Last 14 days, Last 30 days) displayed in statistics commands. #### [**Chart Period**](/dashboard/periods) Allows you to define the default time range used in chart commands.
# Premium Information about VoiceStats premium membership. ## What are the premium perks and where can I purchase it? You can find and purchase all the benefits, differences, and limits of the premium membership on our [website](https://voicestats.xyz/premium). {% embed url="" %} ## How Do I Activate Premium for a Specific Server? To assign and activate your purchased Premium subscription to a Discord server, follow these steps: 1. Navigate to the Premium management dashboard at . 2. Locate the target server under the **"Connected servers"** section. 3. Click the **"Activate Premium"** button situated directly below the corresponding server card to finalize the upgrade. ## How do I connect my Discord account to Patreon? If you want to claim your benefits via Patreon, you will need to link your Discord account to your Patreon account. You can find detailed instructions on how to do this by reading the [Getting Discord access](https://support.patreon.com/hc/en-us/articles/212052266-Getting-Discord-access) article on Patreon Support. ## Current Features and Limits The current Free and Premium feature comparison is maintained on the [VoiceStats Premium page](https://voicestats.xyz/premium). Check that page for the latest features, limits, plans, and pricing. All-time stats cards and voice, channel, and message leaderboards are available without Premium. Premium adds custom periods, larger limits, automation, and appearance options. ## What is Premium? Premium extends VoiceStats with custom periods, larger limits, automation, and appearance options. All-time stats and leaderboards remain available without Premium. By purchasing a premium membership, you can also support the **development** of VoiceStats. ## What is the money used for? Premium subscription is the only thing that keeps VoiceStats running. We use the money to cover the **development and hosting costs** of VoiceStats. ## Is the premium membership only valid for me? Premium server slots unlock server features for everyone in each activated server. Personal appearance features, such as your own stats and chart background, belong to your account and follow your active Premium membership. The [Profile Appearance](/dashboard/profile) guide explains personal settings. The [Premium Settings](/dashboard/premium-settings) guide explains server slot activation. ## Where can I manage my premium servers? You can manage your premium servers through the VoiceStats web [dashboard](https://voicestats.xyz/dashboard/premium). ## Can I transfer my premium subscription to another server? Yes. Once you subscribe, you can transfer your premium subscription to another server once per week using the web [dashboard](https://voicestats.xyz/dashboard/premium). ## How many servers does my premium subscription cover? Premium Tier I: **1** server Premium Tier II: **3** servers Premium Tier III: **5** servers # Login Log in to the VoiceStats dashboard and select a Discord server to manage. The VoiceStats Dashboard lets you manage your server's statistics settings, filters, modules, and Premium features from one place. ## How to Log In to the Dashboard {% stepper %} {% step %} ### Visit the Website Go to the VoiceStats [website](https://voicestats.xyz/). {% endstep %} {% step %} ### Log In to Your Account Click the **Login** button in the top-right corner. {% endstep %} {% step %} ### Authorize Discord On the Discord authorization screen, click **Authorize** to connect your account. {% endstep %} {% step %} ### Open the Dashboard Click your profile avatar in the top-right corner and select **Dashboard**. {% endstep %} {% step %} ### Select Your Server Find the server you want to configure and click **Manage Server**. {% endstep %} {% endstepper %} {% hint style="info" %} If a server is not listed, make sure you own it or have the **Administrator** permission in that Discord server. {% endhint %} # Profile Appearance Choose your personal Web Leaderboard card color and Premium stats and chart background from your VoiceStats account. Open the account menu in the top-right corner of the website and select **Profile**. Settings on this page belong to your own VoiceStats account, not to one server. ## Web Leaderboard Card Choose the color used on your own card whenever you appear on a public or private Web Leaderboard. The preview shows how the color will look before you save it. Select **Use default** to return to the standard card color. {% hint style="info" %} The Web Leaderboard card color is free. It does not require personal or server Premium. {% endhint %} ## Your Stats & Chart Background With an active personal Premium membership, you can choose one preset background for stats and chart images created about you. The background belongs to the member shown in the image. This means your choice is used for your own stats and charts even when another member opens one of your user statistics commands. It applies across servers where VoiceStats generates your personal stats or chart. Your personal choice takes priority over a server's [Banners](/dashboard/banners) setting for your stats and charts. It does not replace the background of server-wide leaderboard images. Choose **Default** to stop using a personal preset. VoiceStats will then use the server background when one is available, or the standard background otherwise. {% hint style="info" %} Personal stats and chart backgrounds require an active Premium membership on your own account. A server's Premium status does not unlock this personal setting. {% endhint %} ## Save Changes After changing either setting, use **Save changes** in the bar at the bottom of the page. **Reset** restores the last saved selections before you save. # Overview Open VoiceStats settings, modules, activity pages, and filters for your Discord server from one place. The **Overview** page gives you quick access to every VoiceStats area available for the selected server. ## Server Controls Each card opens one dashboard page. The cards cover shared server settings, modules, activity pages, filters, visibility, periods, time units, and timezone. Features marked **Premium** require an active Premium plan for the selected server. Features marked **New** were added recently. ## Manage Server * [Premium Settings](/dashboard/premium-settings) for assigning or removing a Premium server slot. * [Settings](/dashboard/settings) for shared server preferences such as language. * [Banners](/dashboard/banners) for choosing a shared background for generated stats, leaderboard, and chart images (Premium). * [Bot Profile](/dashboard/bot-profile) for customizing the bot's server profile, bio, avatar, and banner (Premium). ## Your Profile Open the account menu in the top-right corner and select **Profile** to manage settings that belong to your own account. You can choose your Web Leaderboard card color for free and, with an active personal Premium membership, choose a background for your own stats and chart images. See [Profile Appearance](/dashboard/profile) for details. ## Modules Dashboard modules include: * [Giveaways](/dashboard/giveaways) for creating and managing server giveaways. * [Role Rewards](/dashboard/role-rewards) for voice-time and message-count milestones. * [Pin Leaderboard](/dashboard/pin-leaderboard) for auto-updating Discord ranking panels. * [Web Leaderboard](/dashboard/web-leaderboard) for a dedicated private or publicly shared ranking page. ## Activity Pages Detailed activity is available on three separate pages: * [Voice Activity](/dashboard/stats/voice-activity) shows time spent in voice channels and the number of participating members. * [Message Activity](/dashboard/stats/message-activity) shows message totals and the number of members who sent messages. * [Member Activity](/dashboard/stats/member-activity) shows the latest member count, joins, and leaves. You can also open the guide for the current page from the **Documentation** link in the dashboard's top bar.
# Premium Settings Learn how to activate VoiceStats Premium features from the dashboard. Assign or remove Premium slots to unlock advanced management tools for your server. ## Premium Status You can manage your server's Premium activation from this page. Premium unlocks the following features for a server: * **Bot activity filtering** β€” Choose whether bot voice time is recorded. * [**Bot Profile**](/dashboard/bot-profile) β€” Customize the bot's server profile, bio, avatar, and banner. * [**Canvas Banners**](/dashboard/banners) β€” Choose a shared preset background for generated stats, leaderboard, and chart images. * **Pinned leaderboard panels** β€” Publish auto-updating ranking panels in text channels. * **Custom Web Leaderboard banner** β€” Replace the default banner on the server's Web Leaderboard page. * **Up to 50 role rewards** β€” Free servers can configure up to 5 voice and message rewards in total. * **Up to 100 member and channel filters** β€” Free servers are limited to 5 each. * **Custom stats and chart periods** β€” Choose a rolling 1–30 day window. * **Overview voice chart custom periods** β€” Inspect server activity over a custom 1–30 day range. {% hint style="info" %} All-time stats and rankings do not require Premium. Premium unlocks custom rolling periods; charts do not offer an all-time view. {% endhint %} ### How to Activate? If you have a Premium subscription, you can assign one of your available server slots to this server by clicking the **Activate Premium** button. The activation takes effect immediately β€” no additional save step is needed. To remove Premium from this server and free up the slot, click the **Remove Premium** button. ### Subscription Info The page also displays your current subscription details: * **Plan** β€” Your Premium tier (Tier 1, 2, or 3). * **Server slots** β€” How many of your available slots are currently in use. {% hint style="info" %} If all of your server slots are in use, you will need to remove Premium from another server before you can activate it on a new one. {% endhint %}
# Settings Configure shared server preferences used by VoiceStats modules from one dashboard page. The **Settings** page under **Manage server** contains preferences shared by VoiceStats modules. ## Server Language The server language controls module-generated content for: * Giveaways created from the Dashboard * Role Rewards * Pin Leaderboard * Future VoiceStats modules that support localized output New server settings default to English (`en-US`). The same value can be changed from the bot's `/settings` menu. This is a server-wide preference. Modules do not maintain separate language settings. A giveaway created with the `/giveaway` command uses the language of the person who creates it instead.
# Banners Choose one preset background for stats, leaderboard, and chart images created by VoiceStats in your server. The **Banners** page controls the shared background used in images that VoiceStats generates for a server. Open the server in the Dashboard and select **Manage server β†’ Banners**. ## Choose a Server Background Select one of the available background presets and save your changes. One preset is used for all generated stats, leaderboard, and chart images in that server. Choose **Default** if you want to return to the standard VoiceStats background. Only the presets shown on the page can be selected. You do not need to upload an image or enter an image URL. {% hint style="info" %} Server canvas backgrounds require an active Premium slot for the selected server. {% endhint %} ## Personal Background Priority A member with an active personal Premium membership can choose a background for their own stats and chart images from [Profile Appearance](/dashboard/profile). When VoiceStats creates an image about that member, their personal choice is used before the server choice. If they have not selected a personal background, the server background is used. Server leaderboard images always use the server background. In short: 1. A personal background is used for that member's own stats and charts. 2. Otherwise, the server background is used. 3. If neither is selected, VoiceStats uses its default background. # Bot Profile Customize how VoiceStats appears in your Discord server with a custom name, bio, avatar, and banner. Bot Profile lets you change how VoiceStats looks in one Discord server. Open the server in the Dashboard and select **Manage server β†’ Bot Profile**. An active Premium slot is required for that server. ## Live Preview A live preview at the top of the page shows how the bot's profile card will appear in Discord. Changes are reflected in the preview immediately so you can review them before saving. ## Profile Details ### Bot Name Set a custom display name for VoiceStats in your server. The name can be up to 32 characters. Leave it empty to use the default VoiceStats name. ### Bio Write a short description that appears on the bot's profile card. The bio can be up to 190 characters. Leave it empty to use the standard VoiceStats bio. ## Profile Images ### Avatar Upload a custom avatar image. Accepted formats are PNG, JPG, and GIF. Each file can be up to 5 MB. Square images work best. Use **Remove** to switch back to the default avatar. ### Banner Upload a custom banner image. Accepted formats are PNG, JPG, and GIF. Each file can be up to 5 MB. Wide images work best. Use **Remove** to delete the banner. ## Reset to Default Select **Save changes** after reviewing the live preview. Use **Reset to default** to remove all customizations at once and return the bot's profile to the standard VoiceStats appearance. These actions only affect how the bot appears in the selected server. ## Update Cooldown Saving changes or resetting the profile starts a one-hour update cooldown. If you try again before it expires, the Dashboard shows how many minutes remain. {% hint style="info" %} Bot Profile is exclusive to Premium servers. {% endhint %} # Giveaways Create, manage, end, and reroll fair weighted giveaways from the VoiceStats Dashboard. VoiceStats Giveaways lets server administrators run random draws with optional role, voice-time, and message-count requirements. Every entry represents one equal chance, so members with more entries have a proportionally higher chance of winning. Open **Manage server β†’ Modules β†’ Giveaways** in the [VoiceStats Dashboard](https://voicestats.xyz/dashboard). You must own the server or have **Administrator** permission in Discord to create or manage giveaways. ## Giveaway Page The page contains four sections: * **Active giveaways** shows giveaways that are still accepting entries. From here you can edit, end, or delete a giveaway. * **Giveaway templates** stores reusable configurations. From here you can create, edit, or delete a template. * **Scheduled giveaways** shows giveaways that will be created later. From here you can create, edit, or delete a schedule. * **Ended giveaways** shows completed giveaways in pages of 3. From here you can select new winners when a reroll is needed. Use **New giveaway** to open the normal creation form. Templates and scheduled giveaways have their own create buttons and management forms.
## Basic Details Every giveaway has the following main settings: * **Prize:** The title shown in the giveaway message. It can contain up to 256 characters. * **Channel:** The text or announcement channel where VoiceStats posts the giveaway. * **End time:** Choose an exact date and time, or enter a duration such as `30m`, `10h`, or `1d 12h`. The minimum duration is 1 minute. * **Winner count:** The number of different members selected when the giveaway ends. * **Winner role:** An optional role given to the winners when the original giveaway ends.
The **Base template** selector at the top of the creation form is optional. Selecting one copies its saved values into the form so you can review or change them before creating the giveaway. It never creates a giveaway automatically.
After creation, VoiceStats posts a giveaway message with **Entry** and **Participants** buttons. Members use **Entry** to join. Pressing it again shows their current entry status and the option to leave. **Participants** displays the members who are currently entered and how many entries each member has. ## Giveaway Appearance **Embed color** is available on every plan. Choose a color from the reusable color picker or enter its `#RRGGBB` value. New giveaways use the standard VoiceStats giveaway color by default.
Premium servers can also customize the **Entry** button's style and emoji. The style can be Primary, Secondary, Success, or Danger. The emoji picker supports standard Unicode emojis and automatically loads custom emojis from the current server when opened. Select a custom server emoji directly from the picker. The button label itself is not customizable.
## Giveaway Templates Templates save a reusable giveaway configuration without creating or posting a giveaway. A template has a name and uses a **duration** such as `30m`, `10h`, or `1d 12h` instead of a fixed end date and time. The minimum duration is 1 minute. You can create a template in either of these ways: * Select **Create template** in the Giveaway templates section and complete its form. * Complete the normal New giveaway form, select **Save as template**, and enter a template name. Templates can be created, edited, and deleted only in the Dashboard. Use `/giveaway templates` to view them in Discord. Free servers can save 1 template, while Premium servers can save up to 100. ## Scheduled Giveaways A scheduled giveaway creates and posts a new giveaway at the selected **start date and time**. Creating a schedule does not post the giveaway immediately. The schedule form can optionally load a base template in the same way as the normal creation form. You can then change the copied settings before saving the schedule. Turn on **Repeating** to run the schedule again after a whole-number interval measured in minutes. The minimum repeat interval is 1 minute. Leave Repeating off when the giveaway should run once. Scheduled giveaways can be created, edited, and deleted only in the Dashboard. Use `/giveaway scheduled` to view them in Discord. This feature requires Premium and currently supports 1 scheduled giveaway per server. ## Entry Requirements All entry rules are optional. A member must pass every configured rule unless a bypass role applies.
### Required Roles Choose the roles a member needs before entering. You can require: * **All selected roles**, which is the default; or * **Any one selected role**. ### Bypass Roles A member with any selected bypass role can skip the required-role, required-voice-time, and required-message rules. A blacklist role still prevents entry even when the member also has a bypass role. ### Blacklist Roles Members with any selected blacklist role cannot enter the giveaway. ### Required Voice Time Require a minimum amount of total voice time recorded for the member in the server. Enter whole hours and minutes, such as `1h 15m`. The minimum is 1 minute and the maximum is 30,000 hours. VoiceStats includes the member's currently active voice session when checking this requirement. ### Required Messages Require a minimum total number of messages recorded for the member in the server. Enter a whole number between `1` and `1,000,000,000`. Messages excluded by the server's bot, member, or channel filters do not count toward this requirement. ## Extra Entries for Roles Every eligible member normally receives **1 entry**. Extra-entry roles can change that amount in one of two ways.
### Highest Role Value β€” Default When **Stack role bonuses** is off, each configured number is the member's total entry count. If a member has more than one matching role, only the highest value is used. Example: * Role A: 10 entries * Role B: 20 entries * A member with both roles receives 20 entries. ### Stack Role Bonuses When **Stack role bonuses** is on, every matching role is added to the member's normal entry. Example: * Normal entry: 1 * Role A: +10 entries * Role B: +20 entries * A member with both roles receives 31 entries. The participant list shows each member's entry count, making these differences visible to the server. ## Role Changes After Joining **Protect participants** is enabled by default. * When enabled, later role changes are ignored and do not change or remove entries that members already received. * When disabled, later role changes can update a member's entry count or remove the member when they no longer meet the rules.
If a member is removed because they no longer qualify, becoming eligible again does not automatically rejoin them. They must press **Entry** again. Leaving the Discord server removes the member from active giveaways regardless of this setting. Role changes are applied when VoiceStats receives them. Changes made while VoiceStats is unavailable are not recalculated later. If a required, bypass, blacklist, or extra-entry role is deleted from a live-updating giveaway, VoiceStats automatically protects the entries that are already present. It does not rewrite the giveaway's saved role choices. ## Editing an Active Giveaway The edit form shows all original settings, but only these fields can be changed: * Prize * Winner count * Winner role * End time or remaining duration * Embed color and Entry button The channel and all entry rules stay locked. To use different entry rules, delete the active giveaway and create a new one. ## Ending and Deleting A giveaway ends automatically at its scheduled time. You can also use **End giveaway** to stop entries immediately and select the winners early. In Discord, administrators can right-click the giveaway message and choose **Apps β†’ End Giveaway** for the same immediate action without entering a message ID. When the original giveaway ends, VoiceStats announces the winners in Discord and gives the configured winner role. A member can only occupy one winner position in the same draw. Only active giveaways can be deleted. Deleting one permanently removes it and attempts to remove its Discord message. Ended giveaways are kept so they can be viewed and rerolled. ## Selecting New Winners Use **Select new winners** on an ended giveaway when a replacement winner is needed. Administrators can also right-click the ended giveaway message and choose **Apps β†’ Reroll Giveaway**. This shortcut uses the giveaway's configured winner count and excludes the winners from the previous draw. The **Exclude previous winners** option is enabled by default. It excludes only the winners from the immediately previous draw. Winners from earlier rounds can be selected again. Turning the option off allows the immediately previous winners to be selected again as well. Rerolls announce the new winners but do not remove roles from earlier winners and do not automatically give the winner role to the new winners. ## Giveaway Language * A giveaway created from the Dashboard uses the server language selected under **Manage server β†’ Settings**. * A giveaway created with `/giveaway create` uses the Discord language of the person who creates it. * The public giveaway message keeps that language for its lifetime. * Private button replies, participant pages, and error messages use the Discord language of the member interacting with the giveaway. ## Free and Premium Limits
LimitFreePremium
Active giveaways5100
Giveaway templates1100
Scheduled giveawaysβŒβœ…
Winners per giveaway20100
Maximum duration30 days180 days
Required roles5100
Bypass roles5100
Blacklist roles5100
Extra-entry roles5100
Entries assigned to one role30300
Entry button style and emojiβŒβœ…
{% hint style="info" %} See [Premium](/general/premium) for the complete VoiceStats plan comparison. {% endhint %} # Role Rewards Automatically reward members with Discord roles when they reach configured voice-time or message-count milestones. Role Rewards lets a server award Discord roles for tracked voice activity and counted messages. The module is configured from the VoiceStats Dashboard. ## Requirements VoiceStats needs the **Manage Roles** permission before the module can be enabled. The bot's highest role must also be above every configured reward role in the Discord role hierarchy. ## Configuration 1. Open **Role Rewards** under **Modules** in the dashboard. 2. Add a voice reward with a required duration, or a message reward with a required message count. 3. Optionally select a text channel for reward announcements. 4. Choose how earned roles should be retained. 5. Enable the module and save the settings. Each reward must use a unique Discord role. Voice durations must be unique among voice rewards, and message counts must be unique among message rewards. Free servers can configure up to **5 total rewards** and Premium servers up to **50 total rewards**. If Premium ends, the first five configured rewards remain available. Roles that members already earned are not removed.
Voice durations are entered as hours and minutes, such as `10 minutes`, `1 hour 30 minutes`, or `100 hours`. Message rewards use a whole message count, such as `100`, `1,000`, or `10,000 messages`.
The announcement channel is optional. Select a text channel when you want VoiceStats to announce newly earned rewards, or use the **X** inside the selector to clear it.
## Role Retention The dashboard provides two retention modes: * **Keep every earned role:** Members keep all reward roles they reach. * **Keep only the highest earned role:** When a member reaches a higher configured reward of the same activity type, VoiceStats grants the new role and removes the lower reward role of that type.
Voice and message rewards are handled as separate groups. A member can therefore keep their highest voice reward and their highest message reward at the same time. VoiceStats never removes a member's highest earned reward merely because their member or server statistics were reset. It also never performs a backwards downgrade. Lower reward roles are removed only when a new, higher reward is earned while **Keep only the highest earned role** is enabled. ## When Rewards Are Evaluated Voice rewards are checked after a member leaves a tracked voice channel or moves to another tracked channel. Message rewards are checked as members send counted messages. A member who has already passed a voice milestone receives the reward after their next tracked voice activity. Activity excluded by the server's bot, member, or channel filters does not count toward rewards. ## Troubleshooting If a reward is not granted, check the following: * The module is enabled. * VoiceStats has **Manage Roles**. * The reward role is below the bot's highest role and is not managed by another integration. * The member performed the relevant tracked activity after reaching the milestone. * The member does not already have that reward role. If announcements are missing but roles are still granted, verify that the selected text channel exists and VoiceStats can view and send messages in it.
# Web Leaderboard Share your server's top voice and message activity on a dedicated VoiceStats leaderboard page. Web Leaderboard gives your server a dedicated page for its voice and message rankings. Every server with VoiceStats has a leaderboard page at: `https://voicestats.xyz/leaderboard/` Settings are managed from **Modules β†’ Web Leaderboard** in the VoiceStats Dashboard. ## What the Page Shows Visitors can switch between **Voice** and **Messages** rankings and choose one of the following time periods: * **All time** * **30 days** * **7 days** * **1 day** {% hint style="success" %} All four Web Leaderboard periods, including **All time**, are available to Free and Premium servers. {% endhint %} Each ranking lists the top 10 members with their display name, avatar, position, and activity value. The leaderboard data refreshes every 5 minutes. ## Your Stats Members who sign in with Discord can see their own rank and activity value alongside the leaderboard. Visitors who are not signed in are shown an option to sign in. ## Personal Card Color Every signed-in member can choose the color used on their own Web Leaderboard cards. Open the account menu in the top-right corner, select **Profile**, choose a color under **Web Leaderboard card**, and save. This setting is free and applies whenever that member appears on a public or private Web Leaderboard. It does not change other members' cards. See [Profile Appearance](/dashboard/profile) for more information. ## Voice Time Format Voice durations use the server's selected [Time Units](/dashboard/time-units) format. Changing this setting updates how voice values are written on the Web Leaderboard; it does not change recorded activity. ## Role Rewards If the server has voice or message role rewards configured, they are displayed on the leaderboard page so visitors can see the available milestones. ## Leaderboard Access The leaderboard is **public by default** β€” anyone with the link can view it without signing in. Turn on **Make leaderboard private** to restrict access. When the leaderboard is private, only people who can access the server's dashboard can view it. A visitor who is not signed in is redirected to Discord login and returned to the leaderboard afterward. You can switch between public and private at any time without changing the leaderboard address. ## Custom Banner Premium servers can replace the default server banner with a custom image URL. Enter an HTTPS image URL in the **Banner image URL** field. Leave it empty to use the Discord server banner. {% hint style="info" %} Custom Web Leaderboard banner is exclusive to Premium servers. {% endhint %} This custom URL changes the banner on the Web Leaderboard webpage only. The preset backgrounds used in images generated by the bot are managed separately under [Banners](/dashboard/banners). # Pin Leaderboard Publish auto-updating voice and message ranking panels in your server's text channels with VoiceStats Pin Leaderboard. Pin Leaderboard displays your server's voice or message activity as continuously updated ranking panels in selected text channels. The dashboard provides separate **Voice leaderboard** and **Message leaderboard** sections. You can configure panels for the following time ranges: * **All time** β€” The complete activity ranking. * **Last 30 days** β€” A continuously rolling monthly view. * **Last 7 days** β€” A continuously rolling weekly view. * **Last 1 Days** β€” A focused daily activity view. For each time range, select the destination text channel where the ranking panel should be published. Use the **X** inside the channel selector to turn off a panel. Panels are automatically updated every 15 minutes with the latest voice stats. All configuration is managed via the VoiceStats Dashboard. ### Panel Language Generated leaderboard messages use the server language configured under **Manage server β†’ Settings**. The value shown on this page is read-only; Pin Leaderboard does not have its own language setting. ### Reporting Timezone Panels use the server's timezone setting configured on the **Timezone** page. This is displayed as a read-only reference so you know which timezone boundaries are being used. ### Auto-Deactivation Panels may be automatically disabled if certain conditions occur. When this happens, the dashboard will display a warning explaining the reason: * **Missing permissions** β€” The bot no longer has permission to send messages in the configured channel. * **Channel deleted** β€” The destination channel was deleted from Discord. * **Premium expired** β€” The server's Premium subscription has ended. To re-enable a deactivated panel, resolve the underlying issue and assign a new destination channel. ### Premium Tier Limits The maximum number of active panels that can be configured simultaneously is determined by the server's Premium Tier level: * **Tier 1:** Maximum of **1** panel. * **Tier 2:** Maximum of **2** panels. * **Tier 3:** Maximum of **4** panels.
{% hint style="info" %} **πŸ’Ž Note:** This feature is exclusive to Premium servers. {% endhint %} # Stats Understand all-time statistics and recent activity charts in VoiceStats. VoiceStats provides stats cards and rankings for overall activity, while the Dashboard activity pages use charts to show how your server changes over recent periods. ## All-Time Statistics Are Free All-time statistics and leaderboards are available to both Free and Premium servers. They can show the complete history VoiceStats has recorded for your server. You can view all-time activity through: * User, server, and channel stats cards * Voice, channel, and message rankings * The [Web Leaderboard](/dashboard/web-leaderboard) See [User Commands](/general/commands/user-commands), [Server Commands](/general/commands/server-commands), and [Channel Commands](/general/commands/channel-commands) for the available stats and ranking commands. {% hint style="info" %} Charts do not offer an all-time view. Free servers can use the standard chart periods. Premium adds custom periods from 1 to 30 days. {% endhint %} ## Dashboard Activity Pages * [Voice Activity](/dashboard/stats/voice-activity) shows voice time and participation. * [Message Activity](/dashboard/stats/message-activity) shows message totals and participating members. * [Member Activity](/dashboard/stats/member-activity) shows member count, joins, and leaves. # Voice Activity See how long members spend in voice channels and how voice participation changes over time. The **Voice Activity** page shows how your community uses voice channels during the selected period. ## What You Can See The summary shows: * Total time spent in voice channels * Number of different members who joined voice channels * Number of voice sessions being tracked now The chart compares voice time with the number of participating members. Move over the chart to see the values for a specific time. ## Choosing a Period Free servers can view **1 day**, **14 days**, and **30 days**. Premium servers can also choose a custom period from 1 to 30 days. Changing the period only changes what this page displays. It does not change the server's default period or remove earlier statistics.
{% hint style="info" %} Filters set on the [Bot Filter](/dashboard/bot-filter), [Member Filter](/dashboard/member-filter), [Channel Filter](/dashboard/channel-filter), and [Role Filter](/dashboard/role-filter) pages affect which new activity is counted. {% endhint %} # Message Activity See how many messages members send and how participation changes over time. The **Message Activity** page shows how active your community is in text channels during the selected period. ## What You Can See The summary shows: * Total messages sent * Number of different members who sent messages * Messages sent during the busiest period shown on the chart The chart compares message totals with the number of participating members. Move over the chart to see the values for a specific time. ## Choosing a Period Free servers can view **1 day**, **14 days**, and **30 days**. Premium servers can also choose a custom period from 1 to 30 days. Changing the period only changes what this page displays. It does not change the server's default period or remove earlier statistics.
{% hint style="info" %} Filters set on the [Bot Filter](/dashboard/bot-filter), [Member Filter](/dashboard/member-filter), [Channel Filter](/dashboard/channel-filter), and [Role Filter](/dashboard/role-filter) pages affect which new activity is counted. {% endhint %} # Member Activity Follow your server's member count and see how many people join or leave over time. The **Member Activity** page shows how your server's member count changes during the selected period. ## What You Can See The summary shows: * Latest recorded member count * Members who joined * Members who left The chart shows the member count together with joins and leaves. Move over the chart to see the values for a specific time. If no member change has been recorded yet, the page explains that activity will appear after the first join or leave. ## Choosing a Period Free servers can view **1 day**, **14 days**, and **30 days**. Premium servers can also choose a custom period from 1 to 30 days. {% hint style="info" %} Changing the period only changes what this page displays. It does not remove earlier statistics. {% endhint %}
# Bot Filter Configure the VoiceStats bot filter via the dashboard to easily hide the voice statistics of other Discord bots from your server's leaderboards. ## Record Bot Statistics Choose whether activity from other Discord bots is included in voice-time and message statistics. When enabled, bots can accumulate voice time and message counts and appear in the related rankings. Turning the setting off stops new bot activity from being counted; it does not delete previously saved statistics. When bot statistics are enabled, activity from music bots, recording bots, and any other active bots in voice channels is included in the server's statistics.
{% hint style="info" %} **πŸ’Ž Note:** This feature is exclusive to Premium servers. {% endhint %} # Member Filter Learn in detail how to exclude specific Discord members from VoiceStats voice statistics and leaderboards using the web management dashboard. ## Members Blacklist If you do not want specific members' voice or message activity to be counted, you can exclude them using this filter. Adding a member stops new voice and message activity from being recorded. It does not reset or reduce statistics recorded earlier. You can choose whether historical data remains visible from the [Visibility](/dashboard/visibility) page. ### How to add? Enter the Discord User ID of the member you want to filter into the input field and click the **+ Add member** button. Don't forget to save your settings.
{% hint style="info" %} **πŸ’Ž Limit Info:** Free servers can add a maximum of 5 members to the blacklist. For [Premium](/general/premium#plan-comparison) servers, this limit is increased up to 100 members. {% endhint %} # Channel Filter Configure the channel filter via the dashboard to exclude specific Discord channels, like private rooms or staff chats, from VoiceStats tracking. ## Channels Blacklist If you do not want activity in specific voice or text channels to be tracked, you can add those channels to the filter. For example, you can exclude an AFK voice channel, a private staff room, or a text channel that should not contribute to message statistics. Adding a channel stops new activity in that channel from being recorded. It does not reset or reduce voice time that was recorded earlier. You can choose whether that historical data remains visible from the [Visibility](/dashboard/visibility) page. ### How to add? Select the channel you want to exclude from the **Select a channel** menu, then click the **+ Add channel** button. Don't forget to save your settings.
{% hint style="info" %} **πŸ’Ž Limit Info:** Free servers can add a maximum of **5 channels** to the blacklist. For [Premium](/general/premium) servers, this limit is increased up to **100 channels**. {% endhint %} # Role Filter Configure the role filter via the dashboard to stop tracking new voice and message activity for members with selected Discord roles. ## Roles Blacklist If you do not want members with specific roles to contribute to voice or message statistics, you can add those roles to the filter. A member is filtered when they have at least one selected role. Adding a role stops new voice and message activity for matching members from being recorded. It does not delete statistics recorded earlier, and those historical entries can remain visible in rankings. Removing the role from the filter resumes tracking for future activity. ### How to add? Select the role you want to exclude from the **Select a role** menu, then click the **+ Add role** button. Don't forget to save your settings. The `@everyone` role cannot be filtered.
{% hint style="info" %} **πŸ’Ž Limit Info:** Free servers can add a maximum of **5 roles** to the blacklist. For [Premium](/general/premium) servers, this limit is increased up to **100 roles**. {% endhint %} # Visibility Configure visibility settings via the VoiceStats dashboard. Manage how historical entries, filtered members, and deleted channels are presented in rankings. The Visibility settings page allows you to configure which historical entries VoiceStats presents in rankings and channel breakdowns via the dashboard. These controls solely affect the presentation of data; they never delete recorded voice activity or alter the total server statistics. ### Settings and Functions The following configurations determine how statistics are filtered for users and channels. #### Filtered Ranking Entries Allows you to keep tracking filters separate from the way existing historical data is presented. * Hide filtered members and channels: When enabled, filtered members are removed from user rankings and channel member lists. Likewise, filtered channels are removed from channel rankings and member channel breakdowns. This also recalculates the rank shown on user statistics cards without filtered members. Turning the option off makes historical entries visible again, but does not resume tracking for members or channels that are still filtered.
#### Deleted Channel History Allows you to manage historical voice time statistics for a Discord channel even after it has been deleted. * Show deleted channels: When disabled, deleted channels are hidden from channel rankings and member channel breakdowns. However, their recorded time remains fully included in the server's overall total. Deleted channel history is shown by default. Hiding it only cleans up rankings and member channel lists; it never removes the recorded history.
# Periods Configure statistics and chart periods via the VoiceStats dashboard. Easily manage default time windows and customize data presentation for your server. The Periods settings page allows you to configure the default time windows VoiceStats uses for statistics and generated charts. These settings do not delete or limit any stored voice activity. ### Statistics Period Used by voice, channel, and ranking commands when no specific period is specified by the user. * Last day: Uses the most recent 24 hours. * Last 14 days: Keeps rankings focused on recent activity. * All time: Uses the server's complete recorded history. * Custom: Allows you to choose a rolling window from 1 to 30 days.
### Chart Period Used as the default date range whenever VoiceStats generates a statistical chart. * Last day: Builds charts from the most recent 24 hours. * Last 14 days: Provides a compact view of recent trends. * Last 30 days: Shows a broader monthly trend. * Custom: Allows you to choose a rolling window from 1 to 30 days. {% hint style="success" %} **All-time statistics are free.** The **All time** statistics period is available to every server and uses the complete history VoiceStats has recorded. Charts do not offer an all-time view. {% endhint %}
{% hint style="info" %} **πŸ’Ž Note:** Custom period options are exclusive to Premium servers. {% endhint %} # Time Units Choose how voice durations are written in the bot and on your server's Web Leaderboard. ## Time Unit Format You can customize how time units are displayed in your server's voice statistics. This setting affects all voice time displays throughout the bot. This changes only written duration values. It does not change generated charts, reporting periods, or recorded voice activity. The selected format is also used for voice values on the server's Web Leaderboard. ### Options Select the format that best suits your community and save: * **Full format** β€” e.g., `1y, 2mo, 3w, 2d, 5h, 30m` * **Month format** β€” e.g., `1mo, 5d, 12h` * **Week format** β€” e.g., `2w, 3d, 8h` * **Day format** β€” e.g., `2d, 10h, 30m` * **Hour format** β€” e.g., `72.5h, 30m, 10s`
{% hint style="info" %} Time Units is available to both Free and Premium servers. Server administrators can change it from the Dashboard or the bot's `/settings` menu. {% endhint %} # Timezone Learn how to configure your server's timezone via the VoiceStats dashboard and synchronize statistics with your local time perfectly. The timezone setting ensures that the dates and times displayed in the voice statistics and charts are synchronized with your server's local time. All time-related statistics will be adjusted accordingly. ### How to Change? Use the **Timezone** dropdown menu or search for the timezone that matches your server's primary region (e.g., `UTC+03:00 Β· Istanbul`) from the list, then save.
# Changelog New updates and improvements {% updates format="full" %} {% update date="2026-08-13" tags="bot,website" %} ## :bar\_chart: New: Member Activity & Role Filter! Hello everyone! This update brings two new features at once: **Member Activity**, which tracks your server's growth, and **Role Filter**, which lets you exclude stats from roles you choose! :partying\_face: ### :busts\_in\_silhouette: Member Activity You can now track your server's member count, joins, and leaves both from a command and from the dashboard. * **/members chart:** View your server's member count, join, and leave graph right in Discord. * **New Dashboard Page:** The "Member Activity" page shows the same graph, along with total joins and leaves for your selected period. * **Period Selection:** 1-day, 14-day, and 30-day ranges, plus a custom period with Premium β€” the same setup as our other stats pages. ### :shield: Role Filter If you don't want the stats of members with certain roles to be counted at all, you can now set that up with a single click. * **How It Works:** Members with a role you've added to the filter won't have their new voice and message activity recorded. * **Existing Data Stays Safe:** The filter only stops new activity β€” a member's previously accumulated stats and ranking entries are not deleted. * **Three Ways to Manage It:** Manage it from the "Role" filter page on the dashboard, with the `/filter roles add` and `/filter roles remove` commands, or from the "Role Filter" section in the `/settings` menu. * You can add up to 100 filtered roles per server. Enjoy your voice chats! :green\_heart:
{% endupdate %} {% update date="2026-08-13" tags="bot,website" %} ## :tada: New: Giveaway System! Hello everyone! One of the systems we put the most work into is finally live: a brand new, end-to-end customizable **Giveaway** system! :partying\_face: ### :desktop: Two Ways to Create You can create a giveaway either with a slash command or through the dashboard. * **Via command:** Use `/giveaway create` to quickly start a giveaway by setting the prize, channel, duration, winner count, and more all at once. * **Via dashboard:** The new "Giveaways" page lets you configure the same settings through a much easier interface, with even more detail available β€” for more complex giveaways, we recommend the dashboard. ### :bookmark\_tabs: Templates & Scheduled Giveaways * **Giveaway Templates:** Save your frequently used giveaway settings as a template and reuse them with a single click. * **Scheduled Giveaways:** Schedule your giveaways for a future date, you can also set up recurring giveaways. ### :microphone2: Entry Requirements You can add as many entry requirements to your giveaways as you'd like: * **Voice Time Requirement:** The biggest feature of this update! Create giveaways only members who've reached a voice duration you set can enter. * **Message Count Requirement:** Limit giveaways to members who've reached a minimum message count. * **Required Roles:** Restrict entry to members with specific roles. * **Bypass Roles:** Members with these roles skip the role, voice time, and message requirements entirely and can enter directly. * **Blacklist Roles:** Members with these roles can never enter, no matter what. ### :star2: Roles That Grant Extra Entries You can give members with certain roles extra entries into the giveaway. With "Stack role bonuses," you can either add the bonuses from every eligible role a member holds, or keep it so only the highest-value role bonus applies. ### :art: Visual Customization * **Embed Color:** Customize the giveaway embed's color. * **Entry Button:** Customize the button's color and emoji. Enjoy your voice chats! :green\_heart:
{% endupdate %} {% update date="2026-08-13" tags="bot,website" %} ## :speech\_balloon: New: Message Statistics! Hello everyone! Today we're rolling out one of the biggest additions yet: VoiceStats now tracks message activity right alongside your voice stats! :partying\_face: ### :bar\_chart: Message Stats, Just Like Voice Message activity is now tracked with the same ranking, chart, and stats structure you're already used to from voice. * **/message stats** β€” displays a member's message statistics. * **/message ranking** β€” displays the server's message ranking. * **/message chart** β€” displays a member's message chart. * **/message server chart** β€” displays the server's message chart. * **/message server stats** β€” displays server-wide message statistics. ### :desktop: New Dashboard Page: Message Activity A new "Message Activity" page has been added right next to "Voice Activity" on the dashboard. * **Overview Graph:** Total messages, unique senders, and messages during the busiest period for your selected time range. * **Period Selection:** 1-day, 14-day, and 30-day ranges, plus a custom period with Premium β€” the exact same setup as voice stats. ### :link: Shared Filters Message stats use the same Bot, Member, Channel, and Role filters you've already set up for voice stats β€” configure them once, and they apply everywhere. ### :gear: Module Renames Two existing modules have been expanded to cover messages as well, and renamed to reflect that: * **Voice Role Rewards β†’ Role Rewards:** reward milestones can now be based on voice time or message count. * **Pin Voice Leaderboard β†’ Pin Leaderboard:** pinned leaderboards can now show voice or message rankings. That's not all we've shipped! Our new giveaway system, member charts, and role filter are already live too β€” we'll cover each of them in detail in upcoming announcements. Enjoy your voice chats! :green\_heart:
{% endupdate %} {% update date="2026-07-29" tags="bot,website" %} ## :rocket: VoiceStats V2 is Live! Hello everyone! After a long stretch of work behind the scenes, VoiceStats V2 is finally here! This update brings some of our most requested features to life. :partying\_face: ### :trophy: Highly Requested Feature: Voice Time Rewards The most requested feature is finally here! Members can now automatically earn role rewards once they reach the voice duration you set. * **Easy Setup:** Turn the module on or off with a single click from the new "Voice role rewards" page on the dashboard. * **Duration-Based Milestones:** Set a target duration in hours and minutes for each role; the role is granted automatically once a member reaches it. * **Role Retention Setting:** Choose whether members keep every role they've earned, or only their highest (most recently reached) reward. * **Announcement Channel:** Set a text channel to automatically announce when a member earns a reward. * Free servers can configure up to 3 rewards, Premium servers up to 30. ### :bar\_chart: Server Graph on the Dashboard You can now track your server's voice activity at a glance on the web dashboard, no command needed. * **Overview Graph:** An activity graph showing total voice duration and unique user count has been added to the "Overview" page. * **Instant Numbers:** See total voice duration, unique user count, and currently active sessions at a glance, along with when peak activity happened. * **Period Selection:** Switch between 1-day, 14-day, and 30-day ranges with a single click; with Premium, you can also set a custom period like the last X days. ### :loud\_sound: New Command: /channel chart You can now look at a single voice channel's stats on its own. Use `/channel chart` to view the duration and user graph for a channel you pick, complete with period and timezone info. Alongside these, we've also shipped several bug fixes, minor UI tweaks, and general system optimizations. Enjoy your voice chats! :green\_heart:
{% endupdate %} {% update date="2026-07-23" tags="bot,website" %} ## :zap: Update: New Features, Speed & Visibility Settings! Hello everyone! Thanks to the recent maintenance we performed, integrating new features into the bot is now much easier and faster. Today, we are excited to roll out our latest optimizations and features! :rocket: ### :sparkles: What's Changed? * **Performance Boost:** Major optimizations have been made to the channel ranking and channel stats commands. They now respond significantly faster! * **Advanced Visibility Settings:** We have added new Visibility options to both our web dashboard and bot settings. * You can now choose to hide filtered members and channels from your ranking lists. * You now have full control to show or hide the history of deleted channels in the rankings. * You can easily manage these options directly on Discord via the `/settings` menu under the "Ranking Visibility" and "Deleted Channels" filters. * **Fetch Channels:** We've added a new "Fetch channels" button to the website dashboard. If a newly created voice channel isn't showing up on your dashboard, you can simply use this button to instantly sync and display it! ### :wrench: Command Changes * To reduce clutter, the `/reset channel stats` command has been completely removed. * The `/premium` command has been simplified for a cleaner experience. Checking and managing your premium status is now much easier directly through our dashboard: Thanks to this stronger foundation, we plan to release some amazing new features in the upcoming weeks. Enjoy your voice chats! :green\_heart:
{% endupdate %} {% update date="2026-07-18" tags="bot,website" %} ## :rocket: MAJOR UPDATE: A Completely New Website & Dashboard! Hey everyone! We’ve been building (and rebuilding) heavily behind the scenes, and today we’re thrilled to launch the brand new VoiceStats website and dashboard. Our main goal with this rewrite was simple: to deliver a much cleaner, faster experience today, and to build a stronger foundation for all the massive features we plan to add in the future. ### :art: A Completely New Website The website and dashboard have been fully redesigned to make everything easier to understand and navigate. * We are officially saying goodbye to the old gray layout. It has been replaced by a modern, eye-catching dark theme featuring sleek bluish and greenish tones. * A complete redesign of the Home, Commands, Premium, and Status pages. * Clearer structure, better typography, and a significantly smoother browsing experience. ### :sparkles: The Dashboard Experience The dashboard is now fully modular, ensuring you never get lost while configuring your server. * Instead of cramped settings, we introduced a modular, card-based layout that gives elements more breathing room and makes finding specific toggles a breeze. * Since the entire core was rewritten from scratch, page load times and settings updates are now blazing fast. * Managing your filters (Bot, Member, Channel), Time Units, and the newly released "Pin Voice Leaderboard" is now more intuitive than ever. Everything is live right now! Explore the new experience here: If you encounter any issues or would like to share your thoughts on the new design, you can send a message to the [#πŸ“γƒ»feedbacks](https://discord.gg/KjhFNbfyAZ) channel. Enjoy the voice chats! :green\_heart:
{% endupdate %} {% update date="2026-07-12" tags="bot,website" %} ## New Feature: Pin Voice Leaderboard is Live! Hello everyone! We have finally released the highly requested and long-awaited **Pin Voice Leaderboard** system! :rocket: With this new feature, you can set up voice ranking leaderboards that automatically update and stay pinned in your designated text channels. ### :sparkles: System Details * **Automatic Updates:** Pinned leaderboards automatically refresh every 15 minutes to reflect the most up-to-date voice data. * **Flexible Time Periods:** You can create custom leaderboards for any time period you desire, such as "All Time", "Monthly", "Weekly", or "Daily". * **Easy Management:** You can configure this entire system in seconds directly through our web Dashboard. ### :file\_folder: Advanced Channel Selection Along with this major feature, we have also made the channel selection menus on our web dashboard much more user-friendly. Now, when selecting channels in both the **Pin Voice Leaderboard** settings and the **Channel Filter** system, they will no longer appear in a random order. All channels will be listed exactly as they are ordered in your Discord server, complete with their categories. You can visit our web dashboard right now to integrate these new features into your server. Enjoy your voice chats! :green\_heart:
{% endupdate %} {% update date="2026-05-15" tags="website" %} ## Enhanced Member Filter! Hello everyone! We are continuing to improve the user experience on the VoiceStats web dashboard without slowing down. ### :sparkles: What's New? * **Visual Member Filter:** We have brought a great Quality of Life update to the 'Member Filter' page on the dashboard. Now, when you add individuals to the filter list, you won't just see complex ID numbers; you will clearly see their actual profile pictures (avatars) and usernames. * This makes managing your filter list and keeping track of which users are blacklisted much more transparent and effortless! You can [visit](https://voicestats.xyz/dashboard) our website and check out the new interface right now. Enjoy your voice chats! :green\_heart:
{% endupdate %} {% update date="2026-04-19" tags="bot" %} ## Quick Period Selection & Pagination! Hello everyone! We have just released some new Quality of Life updates that will make your VoiceStats experience much faster and smoother. ### :sparkles: What's New? * :calendar\_spiral: **Quick Period Buttons:** You no longer need to waste time manually selecting periods for commands like `/voice ranking`, `/server graph`, and `/user graph`! Thanks to the quick access buttons added below the commands, you can instantly switch between the most commonly used timeframes with a single click. * :gem: **Custom Period (Premium):** You can still view "All Time" statistics on ranking commands completely for free. However, if you want to set a specific, custom timeframe (e.g., the last 17 days), the "Custom Period" option is an exclusive feature for Premium members. To explore Premium perks and upgrade your server, visit: * :page\_facing\_up: **Page Jump:** We are saving large servers with thousands of members from the hassle of clicking through pages one by one! You can now click the page number (e.g., 1/1) located right in the middle of the navigation buttons under the ranking commands, type your desired page, and jump straight to it. * :gear: **Default Settings:** If you consistently use the same period, you can easily change the bot's default behavior permanently for your server via the new "Stats Period" and "Graph Period" options in the `/settings` menu. *Did you like the new period selection feature? You can share your thoughts and feedback with us in the* [*#πŸ“γƒ»feedbacks*](https://discord.gg/KjhFNbfyAZ) *channel!* Thank you, and enjoy your voice chats! :green\_heart:
{% endupdate %} {% update date="2026-03-13" tags="website" %} ## New Filters & Settings! Hello everyone! We have released some great new features on the VoiceStats web dashboard to significantly improve your user experience. :rocket: ### :sparkles: What's New? * :mag: **Easier Channel Filtering:** You no longer need to search for and copy long Channel IDs when setting up your channel filters! You can now quickly create your filters in seconds by directly selecting the desired channels by their names from the dropdown menu. * :globe\_with\_meridians: **Timezone Setting on Dashboard:** The timezone setting, which we previously offered via commands, can now be fully managed directly from the web dashboard! By navigating to the 'Timezone' tab under 'Settings' on the left menu, you can use the search box to easily find and select your server's region. :link: Visit our website now to test out the new features: [**https://voicestats.xyz/dashboard**](https://voicestats.xyz/dashboard) Enjoy your voice chats! :green\_heart:
{% endupdate %} {% update date="2026-03-02" tags="bot" %} ## πŸš€ Massive Performance Update & New Commands! ​ Hello everyone! For those wondering about yesterday's downtime, we have some amazing news. We've made our systems significantly more powerful! :partying\_face: ### :sparkles: What's New? * :dash: **90% Faster Experience:** This was the main focus of yesterday's maintenance! The response times for VoiceStats bot commands and the loading speed of statistics on the web dashboard have been increased by **approximately 90%**. Everything is now incredibly snappy and much smoother! * :mag\_right: **New Filtering Commands:** We have added two new commands to the system so you can analyze your server statistics in much more specific detail: * `/filter channels` * `/filter members` Thank you for your patience during yesterday's maintenance ([status](https://discord.com/channels/1303322739834097728/1310609024307433582/1477511765137817762)) and for using VoiceStats. Thank you, and enjoy your voice chats! :green\_heart: {% endupdate %} {% update date="2026-02-19" tags="bot" %} ## 🌐 New Feature: Time Zone Settings! Hello everyone! We are here with a great update that will further personalize your VoiceStats experience. :partying\_face: You can now view the date and time data in your voice statistics according to your local time! :clock1: ### :sparkles: What's New? * :earth\_africa: **Time Zone Selection:** The new time zone setting determines the time zone used when displaying the date and time of voice statistics. * :mag: **Easy to Use:** You can view your current time zone via the Settings Menu and easily select your region from the dropdown menu (e.g., UTC+00:00). * :calendar: **Instant Preview:** While making your selection, you will see an "Example Date/Time" preview for that specific time zone right next to it. > Don't forget to use the `/settings` command in your server to set this up. Once configured, you can try the `/server graph` and `/my graph` commands to see your new time zone in action on the charts! :chart\_with\_upwards\_trend: Thank you, and enjoy your voice chats! :green\_heart: {% endupdate %} {% update date="2025-12-31" tags="website" %} ## New Status Page ​ We have completely revamped our Status Page, where you can monitor the real-time health and uptime of VoiceStats services! You can now track the bot's status through a much more transparent and detailed interface. ### :sparkles: What's New? * :green\_circle: **System Overview:** You can now clearly see the overall operational status of both the website and the bot at a glance. * :bar\_chart: **Advanced Shard Monitoring:** Hover over the Shard numbers at the bottom to view a detailed popup showing real-time ping, total servers/users served by that shard, and its uptime duration. :link: Check out the new status page on our website: Thank you, and enjoy your voice chats! :green\_heart: {% endupdate %} {% update date="2025-12-31" tags="bot" %} ## VoiceStats December Update Hello everyone! It’s been a while since the last update. I know I haven't posted an announcement for some time. Due to personal matters, I couldn't focus on new features, but I continued fixing bugs in the background. Now, I am back to actively working on VoiceStats full-time! :rocket: ### :sparkles: What's New? * :gem: **Premium System Overhauled:** The premium infrastructure has been completely rewritten from scratch. The issue where memberships weren't automatically activating after purchase is now fixed. The process is now much smoother. * :globe\_with\_meridians: **Language System Renewed:** The language system and translations have been completely renewed from top to bottom to ensure a better experience. * :zap: **Optimization & Bug Fixes:** While there aren't many visible changes on the surface, we've made massive improvements "under the hood" (backend). Many bugs have been squashed, and significant optimizations have been applied to improve performance. Thank you, and enjoy your voice chats! :green\_heart: {% endupdate %} {% endupdates %}