> ## Documentation Index > Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt > Use this file to discover all available pages before exploring further. # Statistics > See how a server is doing with !stats: trends against the period before, the busiest hours, top channels and members, growth and one member's activity, as pictures. ## Overview `!stats` shows how a server is doing and how it changed: six numbers with their **change against the period before**, the **busiest hours of the week**, the top channels and members, how the server **grows** and how long the members who left had stayed, and what **one member** did. Every answer is a picture, so it looks the same for everyone. Everything is counted **per server** (never across servers), in [GMT-5](https://wiki.petto.sbs/setup/time.md). Petto only keeps **numbers**, never what was written, and nobody is counted who asked not to be. > [!NOTE] > > `!stats` used to be another name of [`!summary`](https://wiki.petto.sbs/resources/utility-commands). `!summary` stays as it was (`!digest` and `!weekly` too); `!stats` is now this analysis, with its own aliases `!analytics` and `!analysis`. ## Commands ```javascript Syntax theme={null} !stats [days] !stats channels [days] !stats members [days] !stats heatmap [days] !stats growth [days] !stats compare [days] !stats [@member] [days] !stats privacy ``` ```javascript Example theme={null} !stats !stats 30 !stats heatmap 14 !stats @Someone 90 !stats privacy ``` `days` is a number from **1 to 180** (7 by default; `30` and `30d` mean the same). The period before it has the same length, so `!stats 30` compares the last 30 days with the 30 before them. A cooldown of a few seconds keeps the command from being spammed, because each answer adds up many numbers. | Command | What it shows | | - | - | | `!stats` | The server at a glance: messages, active members, voice time, joins, leaves and messages per day, each with its change in percent, and three charts with the period before as a dashed line. | | `!stats channels` | The channels with the most messages and the most voice time, with their share, and the text channels that stayed quiet. | | `!stats members` | The members with the most messages and voice time, and how much of the total the top of them wrote. | | `!stats heatmap` | The messages of each hour of each weekday, the part of the day (night, morning, afternoon, evening) and the share of each weekday. | | `!stats growth` | Joins and leaves, the line of members, and how long the members who left had stayed (less than a day, a week, a month, up to three months, more). | | `!stats compare` | Every number next to the period before, and how many of every 100 messages have a link, a file or image, are a reply or carry a mention. | | `!stats @member` | What one member did: messages, voice time, days in a row, best day, place in the server and share of the total. Without a member it shows yours. | | `!stats privacy` | Choose not to be counted, or delete what was counted about you. | Short names for the subcommands also work: `!stats top`, `!stats hours`, `!stats vs`, `!stats retention`, `!stats me`, and others. > [accordion] !stats > > ![kira runs !stats and Petto answers with the overview picture: six numbers with their change and three charts, and the busiest time and best day](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-server.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=1dbd1e4e21d1117e9bfdc519de468b76) > > In Discord: the server at a glance, against the 7 days before. > [accordion] !stats channels > > ![Petto shows the top text channels with their share, the two voice rooms and the text channels that had no messages](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-channels.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=5a0cb09bb5093a5888fb302b7c49b540) > > In Discord: the channels with the most messages and voice time, and the quiet ones. > [accordion] !stats members > > ![shi runs !stats members 30 and Petto shows the top 10 members by messages and by voice time](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-members.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=66cbd9960829741a1a1a8500826e14f3) > > In Discord: the members with the most messages and voice time in 30 days. > [accordion] !stats heatmap > > ![liam runs !stats heatmap 14 and Petto shows the week by hour, the parts of the day and the share of each weekday](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-heatmap.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=54ccd955959ab74d15bb8cd7e0c42722) > > In Discord: the messages of each hour of each weekday in 14 days. > [accordion] !stats growth > > ![liam runs !stats growth 30: 591 joined and 173 left, the members line and how long the members who left had stayed](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-growth.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=e493a67f935f53730e8e0eae8069fba1) > > In Discord: joins and leaves, the members line and how long the ones who left had stayed. > [accordion] !stats compare > > ![chu runs !stats compare and Petto shows each number against the 7 days before and how many of every 100 messages have a link, a file, a reply or a mention](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-compare.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=fa5f52b5391cbdb99cdca1466b70441e) > > In Discord: every number next to the period before, and how messages are written. > [accordion] !stats @member > > ![Chillet runs !stats @kira 30 and Petto shows kira's messages, voice time, days in a row, messages per day and place in the server](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-member.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=7a4d2490990ee067a6a635709eeb1bd5) > > In Discord: what one member did in 30 days. ## What the pictures look like > [tab] Overview > > ![The overview card: six numbers with their change and three charts](https://mintcdn.com/wikipetto/e5w6HSN-wn3FJYaf/images/stats/overview.png?fit=max\&auto=format\&n=e5w6HSN-wn3FJYaf\&q=85\&s=3c2c3e3bc2a8176cb6e4a9441241223e) > [tab] Heatmap > > ![The week by hour, as a grid, with the part of the day and the weekdays](https://mintcdn.com/wikipetto/e5w6HSN-wn3FJYaf/images/stats/heatmap.png?fit=max\&auto=format\&n=e5w6HSN-wn3FJYaf\&q=85\&s=c4aa4858bf2311eb8c7bf8f13ff1ccae) > [tab] Channels > > ![The channels with the most messages and the most voice time](https://mintcdn.com/wikipetto/e5w6HSN-wn3FJYaf/images/stats/channels.png?fit=max\&auto=format\&n=e5w6HSN-wn3FJYaf\&q=85\&s=cc597cc82cf4cd413af2d9b8a8c0dd69) > [tab] Members > > ![The members with the most messages and the most voice time](https://mintcdn.com/wikipetto/e5w6HSN-wn3FJYaf/images/stats/members.png?fit=max\&auto=format\&n=e5w6HSN-wn3FJYaf\&q=85\&s=60f19c3938ea5dccea95d32d3823e999) > [tab] Growth > > ![Joins, leaves, the members line and how long the ones who left had stayed](https://mintcdn.com/wikipetto/e5w6HSN-wn3FJYaf/images/stats/growth.png?fit=max\&auto=format\&n=e5w6HSN-wn3FJYaf\&q=85\&s=f8b2cd660007f13c6a241969957c2911) > [tab] Compare > > ![Each number next to the period before, and how messages are written](https://mintcdn.com/wikipetto/e5w6HSN-wn3FJYaf/images/stats/compare.png?fit=max\&auto=format\&n=e5w6HSN-wn3FJYaf\&q=85\&s=d949b48cced9a1ec3874b43aef02bb46) > [tab] Member > > ![What one member did: messages, voice time, streak and place in the server](https://mintcdn.com/wikipetto/e5w6HSN-wn3FJYaf/images/stats/member.png?fit=max\&auto=format\&n=e5w6HSN-wn3FJYaf\&q=85\&s=767329b396f284c127c778c0d6e6c12f) A green change is good news and a red one is not. For **members who left** it is the other way round: fewer leaves is green. A grey **New** means there was nothing in the period before to compare with. The numbers are shortened (`12.3k`, `4.6m`) and a change above 999% is shown as `>999%`. ## For members: choose not to be counted Each person decides about their own numbers with `!stats privacy`. Petto answers with a panel that says if you are counted, with two buttons that only work for the person who asked: * **Do not count me**: from now on **nothing** about you is counted in any server (messages, voice time, reactions, joins or leaves), and what was already counted **about you** is deleted. Once you are out, the button becomes **Count me again**, so you can come back whenever you want. * **Delete my counts**: deletes what was counted about you so far, and you stay counted from now on. Because nothing is counted, you do not appear in any ranking or in `!stats @member`, and your activity does not add to the totals of the servers. The same choice is explained in the [Privacy Policy](https://petto.sbs/privacy#statistics). > [accordion] !stats privacy > > ![Chillet runs !stats privacy and Petto answers with what it counts, that Chillet is counted, and the buttons Do not count me and Delete my counts](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-privacy.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=c05b1ee461642bfb1cc8c4404590ed5f) > > In Discord: the panel of !stats privacy, with its two buttons. > [accordion] Do not count me > > ![The panel after the button: Chillet is not counted anymore and the button is now Count me again](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-privacy-optout.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=7736a3e2de1e390299e0274b7e10b58a) > > In Discord: after Do not count me, the panel says so and offers Count me again. > [accordion] Delete my counts > > ![The panel after Delete my counts: 58 days of counts about Chillet were deleted](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-privacy-delete.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=d7512d62b6a7f2ea282621eb195a0637) > > In Discord: Delete my counts deletes the days counted about you. > [accordion] Someone else presses it > > ![shi presses a button on Chillet's panel and Petto answers, only to shi, that the panel is for someone else](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-privacy-not-yours.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=54e9e2bc3bd65e13e911e7bb8c66d427) > > In Discord: only the person who asked can use the panel. ## For administrators Everything below needs **Manage Server**. The same switches are on the **Statistics** page of the dashboard, in the **Data and privacy** tab. ```javascript Syntax theme={null} !statsconfig !statsconfig enable !statsconfig disable !statsconfig members !statsconfig content !statsconfig delete ``` ```javascript Example theme={null} !statsconfig !statsconfig members off !statsconfig content off !statsconfig delete ``` | Switch | What it does | | - | - | | `enable` / `disable` | Count the server or stop counting anything. While it is off, `!stats` says so and nothing new is kept. Everything is **on** by default. | | `members` | Keep counts **per member**. With it off there are no rankings of members and no `!stats @member`, only the totals and the channels. | | `content` | Count how many messages have a link, a file, a reply or a mention. Only a yes or no per message is kept; **the text is never read or saved**. | | `delete` | Deletes every counter of the server. It asks first, with a button that only the person who asked can press. | `!statsconfig` alone shows what is counted and what is kept. The other names are `!statconfig` and `!analyticsconfig`. > [accordion] !statsconfig > > ![liam runs !statsconfig: counting on, counts per member on, shape of messages on](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-config.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=84dcc57f01fae6c2e2bfd303bb4f5de7) > > In Discord: what the server counts and how long it is kept. > [accordion] !statsconfig enable > > ![liam runs !statsconfig enable and Petto confirms that it counts the activity of the server](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-config-enable.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=9b1a0deb9c1cd52d167ab016695663df) > > In Discord: the statistics turned on. > [accordion] !statsconfig disable > > ![liam runs !statsconfig disable and Petto confirms that nothing is counted from now on](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-config-disable.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=49bf7de17c2692f04a8f132fd5c80194) > > In Discord: nothing new is counted; what was counted stays until it is deleted. > [accordion] !stats with the statistics off > > ![kira runs !stats and Petto answers that the server has the statistics turned off and how to turn them on](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-disabled.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=2a9bb5c3d9ab401ffa804205c52e8664) > > In Discord: while the statistics are off, !stats says so. > [accordion] !statsconfig members off > > ![liam runs !statsconfig members off and Petto explains that there are no more member rankings](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-config-members.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=7ea9aacc558272b971bff5d0aeeef2b5) > > In Discord: no more counts per member. > [accordion] !statsconfig content off > > ![liam runs !statsconfig content off and Petto confirms it](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-config-content.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=34b784855ac00cac8b13ecdf3c63ac7e) > > In Discord: the shape of messages is no longer counted. > [accordion] !statsconfig delete > > ![liam runs !statsconfig delete and Petto warns that it deletes every counter of the server, with the button Delete every counter](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-config-delete.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=e053463b1c8ef4c4f4d067966b2734f4) > > In Discord: Petto asks first, with a button. > [accordion] The button pressed > > ![Petto answers that 18744 counters of the server were deleted](https://mintcdn.com/wikipetto/W92wXuPUuDfMzVq7/images/discord/miscellaneous/statistics-config-deleted.webp?fit=max\&auto=format\&n=W92wXuPUuDfMzVq7\&q=85\&s=82f153116f6b8ec855c0a355c104e679) > > In Discord: after the button, how many counters were deleted. ## What is counted and for how long * **Counted:** messages and voice time per channel and per hour, reactions, members who joined and left (and how long they had stayed), and how many messages had a link, file, reply or mention. Nothing is counted for people who opted out, and per-member numbers only exist if the server keeps them. * **Never kept:** what was written, attachments, who someone talked to, or anything outside the server. * **For how long:** per-member numbers are kept for **13 months** and the totals of the server for **2 years**. A daily job deletes what is older. * Counting starts when the feature is on: there are no numbers before that, so a young server shows a short history. ## Dashboard The **Statistics** page of the [dashboard](https://petto.sbs/dash) has the same analysis in tabs: **Heat map**, **Growth**, **Compare** and **Data and privacy**, next to the ones that already existed (**Overview**, **Messages**, **Voice**, **Joins**, **Leaves**, **Invites** and **Sanctions**). **Data and privacy** has the same switches as `!statsconfig` and the button to delete the counters. The **Invites** tab also has a leaderboard you can filter by all time, this week or this month, a search for one member, and the invite settings: see [Invites](https://wiki.petto.sbs/community/invites.md#dashboard). ![The Statistics page of Petto Land on the Overview tab: messages, active members, voice time, joins, leaves and invites, with the charts and the rankings](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/miscellaneous/statistics.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=8d1294a0c5d155dac83a3d8376dadd9c) Dashboard → Dashboard → Statistics: the numbers of the last 7 days, the messages per day, the busiest hours and the top channels and members. > [accordion] Messages > > ![The Messages tab of the Statistics page of Petto Land, last 7 days](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/statistics-tab-messages.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=79d60d33472064e31d2bf5377c4564ab) > > Dashboard → Dashboard → Statistics → Messages: the messages per day and the most active hours. > [accordion] Voice > > ![The Voice tab of the Statistics page of Petto Land, last 7 days](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/statistics-tab-voice.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=483a3ea82c793d9413127f02acc94803) > > Dashboard → Dashboard → Statistics → Voice: the voice hours per day and the busiest hours. > [accordion] Heat map > > ![The Heat map tab of the Statistics page of Petto Land, last 7 days](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/statistics-tab-heatmap.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=f66b88d826ee7e9bad8da68af5f1ce2d) > > Dashboard → Dashboard → Statistics → Heat map: the messages of each hour of the week. > [accordion] Joins > > ![The Joins tab of the Statistics page of Petto Land, last 7 days](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/statistics-tab-joins.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=32fba9fb2008eb8964bd68cbcaf3210f) > > Dashboard → Dashboard → Statistics → Joins: the members who joined per day and the best days of the week. > [accordion] Leaves > > ![The Leaves tab of the Statistics page of Petto Land, last 7 days](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/statistics-tab-leaves.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=0f98441de9daa89d13fe93083bc4ff41) > > Dashboard → Dashboard → Statistics → Leaves: the members who left per day and the days they leave most. > [accordion] Growth > > ![The Growth tab of the Statistics page of Petto Land, last 7 days](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/statistics-tab-growth.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=920cb3848454d3cb33582b1ccc31bab7) > > Dashboard → Dashboard → Statistics → Growth: the net members per day and how long the ones who left had stayed. > [accordion] Compare > > ![The Compare tab of the Statistics page of Petto Land, last 7 days](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/statistics-tab-compare.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=25c4fe64328fcbb9866e8d8b0196f185) > > Dashboard → Dashboard → Statistics → Compare: each number against the period before. > [accordion] Sanctions > > ![The Sanctions tab of the Statistics page of Petto Land, last 7 days](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/statistics-tab-sanctions.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=232d5379ec2640e626155cbd5bb7e602) > > Dashboard → Dashboard → Statistics → Sanctions: the sanctions per day and by kind. > [accordion] Data and privacy > > ![The Data and privacy tab of the Statistics page of Petto Land, last 7 days](https://mintcdn.com/wikipetto/VR-_hcmj859PB7OS/images/dashboard/miscellaneous/statistics-tab-data.webp?fit=max\&auto=format\&n=VR-_hcmj859PB7OS\&q=85\&s=5eab83b81d5e6d1dfe880a706c164138) > > Dashboard → Dashboard → Statistics → Data and privacy: the same switches as !statsconfig and the button to delete the counters. ## Related * [`!summary`](https://wiki.petto.sbs/resources/utility-commands): the quick report of a server, with its top inviters and sanctions. * [Invites](https://wiki.petto.sbs/community/invites.md): who brought each member (joins through invites are part of the growth numbers). * [Global Stats](https://wiki.petto.sbs/miscellaneous/global-stats.md): the public page with the totals of every server. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.