Counters

Overview

A counter is a channel whose name shows a live value, like 👥 Members: 1,234. Petto makes it locked (everyone sees it, nobody can join or write) and changes its name when the value changes. A counter can also be a category’s name, or the topic of a text channel.

!counter (alias !counters) is a prefix command and needs Manage Channels. Petto needs Manage Channels too, to make and rename the channels. The dashboard has the same under Integrations → Counters.

The Counters page of Petto Land with 6 counters, 1,840 members, the members chart of 30 days, the packs and the first counters — Dashboard → Integrations → Counters: the numbers now, member growth, the packs and the counters of the server.

Quick setup

Example

!counter setup
!counter setup online
!counter setup goal 1000
!counter setup clock Europe/Madrid

!counter setup [pack] makes a ”📊 Server stats” category with a ready set of counters:

Pack	Counters
`basic` (the default)	Members, humans, bots
`boosts`	Boosts, boosters, boost level
`online`	Online (any status), online, in voice
`goal [number]`	A member goal (by default the next round number above your members)
`clock [time zone]`	The time and the date

What the server already counts is skipped, and the pack stops at the counter limit of the server.

!counter setup

!counter setup online

!counter setup goal 2000

!counter setup clock Europe/Madrid

A pack the server already has

liam runs !counter setup basic and Petto answers that the server already counts everything in that pack — In Discord: a pack whose counters the server already has is not made again.

Commands

!counter setup [pack]
!counter create <type> [name] [category] [--kind voice|text|category|stage|topic] [--channel #channel] [--role @role] [--goal number] [--timezone zone] [--format plain|grouped|compact]
!counter list
!counter types
!counter edit <channel> <setting> <value>
!counter delete <channel> [keep]
!counter refresh [channel]
!counter announce [setting] [value]

!counter create members
!counter create humans "👤 People: {count}"
!counter create role @Staff "🛡️ Staff: {count}"
!counter create staffonline @Staff
!counter create goal --goal 500
!counter create clock --timezone America/Bogota
!counter create boosts --channel #general --kind topic
!counter edit #members format compact
!counter delete #members keep

!counter create makes a new locked voice channel, or turns a channel you already have into a counter with --channel #channel.
!counter list (the default of !counter) shows what each counter shows now and any problem it has.
!counter types lists every type with its value right now.
!counter delete deletes the counter and its channel; keep keeps the channel.
!counter refresh updates the counters now, within Discord’s limit.
Short names: add, new for create; remove, rm for delete; sync for refresh; preset, pack for setup.

liam runs !counter list and Petto lists six counters: members, humans, online, boosts, a goal of 2,000 and a clock — In Discord: !counter list shows what each counter shows now and when it changes next.

!counter create members

!counter create role

liam creates a counter of the Staff role named 🛡️ Staff: {count} and it shows 4 — In Discord: a role counter with a name of its own.

An unknown type

liam types !counter create memberz and Petto answers that the type is unknown — In Discord: a type Petto does not know points to !counter types.

!counter types

Petto lists every counter type of Petto Land with its value, like 1,840 members and 412 online — In Discord: every type with its value right now.

!counter delete

liam deletes the clock counter and Petto confirms that the channel was removed — In Discord: the counter and its channel are deleted.

!counter delete … keep

liam runs !counter delete on the boosts counter with keep and Petto says the channel was kept — In Discord: with keep, the channel stays and only the counter stops.

!counter refresh

Without Manage Channels

Toby types !counter create members and Petto answers that the manage_channels permission is missing — In Discord: a member without Manage Channels cannot use !counter.

!counterconfig (needs Manage Server) shows what the server has set for counters and milestone announcements, and every !counter command.

liam runs !counterconfig: the six counters with their type and state, the milestone announcements and the list of !counter commands — In Discord: !counterconfig, the settings of the module and its commands.

Types

Type	What it counts	Also typed as
`members`	Every member	`total`
`users_only`	Humans	`humans`, `users`
`bots_only`	Bots	`bots`
`pending_members`	Members who have not passed the rules screen	`pending`
`online`	Members online, idle or busy	`status`
`status_online`, `status_idle`, `status_dnd`	Members with that one status	`idle`, `dnd`
`in_voice`	Members in a voice channel	`vc`
`role_members`	The members of a role	`role`
`role_online`	The members of a role who are online	`staffonline`, `roleonline`
`boosts`, `booster_count`, `boost_level`	Boosts, boosters and the boost level	`boosters`, `level`
`all_channels`, `text_channels`, `voice_channels`, `categories`, `announcement_channels`, `staging_channels`	Channels of each kind	`channels`, `text`, `voice`
`roles`, `emojis`, `stickers`	Roles, emojis and stickers of the server
`tag_users`	Members wearing this server’s tag	`tag`
`vanity_users`	Members a Vanity rule matches now	`vanity`
`messages_today`	Messages of the day, from the activity stats	`messages`
`goal`	Members out of a goal, like `🎯 Goal: 480/500`	`target`
`clock`, `date`	The time and the date in a time zone	`time`
A 10-digit Unix timestamp	A countdown to that moment

The days of messages_today follow the time of Petto. A clock moves in steps of five minutes, because a channel can only be renamed twice every 10 minutes.

Names and formats

The name of a counter is any text with {count}. New counters get a ready name in the language of the server.

Placeholder	What it shows	Example
`{count}`	The value, in the counter’s format	1204, 1,204 or 1.2k
`{goal}`	For goals: the goal (yours, or the next round number)	1250
`{left}`	For goals: how many are missing	46
`{percent}`	For goals: how far it is	96%
`{role}`	The name of the role of the counter	Staff
`{tz}`	The time zone of a clock	`UTC`, `GMT+2`, `CEST`

These placeholders are only for counter names. The usual variables like {server_name} don’t work here, write the text yourself.

Name ideas

Type	Template	Shows
`members`	`👥 Members: {count}`	👥 Members: 1204
`humans`	`👤 Humans: {count}`	👤 Humans: 1198
`online`	`🟢 {count} online`	🟢 312 online
`goal`	`🎯 {count}/{goal} ({percent})`	🎯 1204/1250 (96%)
`goal`	`🚀 {left} to {goal}!`	🚀 46 to 1250!
`role`	`🛡️ {role}: {count}`	🛡️ Staff: 8
`boosts`	`💎 Boosts: {count}`	💎 Boosts: 9
`clock`	`🕒 {count} {tz}`	🕒 18:35 CEST
`date`	`📅 {count}`	📅 19 Oct 2026

The format can be plain (1234), grouped (1,234, or 1.234 in Spanish and Portuguese) or compact (1.2k). Old counters keep their names, and {value}, {remaining} and {option} still work in them.

Where the value shows

--kind chooses what the counter changes:

voice (the default), text or stage: the name of a channel. Text channels have no spaces or capitals in Discord, so voice looks best.
category: the name of a category.
topic: the topic of a text channel, which keeps its name (up to 1,024 characters). A new one is a locked #server-stats channel, or use one you have with --channel #general.

!counter edit #channel kind topic or kind name switches a text channel between the two.

liam runs !counter create boosts --channel #general --kind topic and Petto says #general now shows 💎 Boosts: 9 — In Discord: --kind topic turns #general into a counter that changes its topic.

Change a counter

!counter edit <channel> <setting> <value> changes one thing: template (the name), format, type, role, goal, timezone, category, kind, prefix, suffix, interval or enabled.

Example

!counter edit #members template "🌸 {count} members"
!counter edit #goal goal 2000
!counter edit #clock timezone Asia/Tokyo
!counter edit #members enabled false

!counter edit … template

liam changes the template of the members counter and Petto shows the preview 🌸 1,840 members — In Discord: a new name, with a preview of what it shows.

!counter edit … format compact

liam sets the members counter to the compact format and the preview shows 👥 Members: 1.8k — In Discord: the compact format writes 1,840 as 1.8k.

!counter edit … goal

liam changes the goal to 2500 and the preview shows 🎯 Goal: 1,840/2,500 — In Discord: a new goal for a goal counter.

!counter edit … timezone

liam moves the clock counter to Asia/Tokyo and the preview shows the time in GMT+9 — In Discord: the clock in another time zone.

!counter edit … enabled false

liam turns the members counter off with enabled false and Petto confirms the change — In Discord: enabled false stops the updates and keeps the counter.

Updates

Discord lets a channel be renamed twice every 10 minutes, and Petto never asks for more. A member joining or leaving, a boost, a new channel or role updates the counter at once when that budget allows; otherwise one rename is planned for when it is allowed again, with the value of that moment. Nothing is renamed when the name would not change, and the budget is kept across restarts. When many counters change at once (a raid, the clocks of every server at the same minute), Petto spreads the renames over a short time instead of sending them together.

Milestone announcements

!counter announce sends a message when the server reaches the goal of a goal counter, and if you want every so many members.

!counter announce
!counter announce channel <#channel>
!counter announce message <text>
!counter announce embed <name|off>
!counter announce every <number|off>
!counter announce goals <on|off>
!counter announce <on|off>
!counter announce test

!counter announce channel #general
!counter announce every 100
!counter announce message 🎉 We are {count} in {server}!
!counter announce test

The text takes {count} (members now), {goal} or {milestone} (the number reached) and {server}, with numbers grouped like 1,000. A saved embed uses {counter.count}, {counter.goal} and {counter.server}, plus the usual variables of the server. With !counter announce message 🎉 We just hit {goal} members in {server}! the server reads 🎉 We just hit 1,000 members in Cozy Corner! The same number is never announced twice: not after a restart, and not when members leave and join again around it. Turning it on starts from the members of that moment.

!counter announce

Petto shows the milestone announcements on, in #general, every 100 members, last announced 1,800 and next 1,900 — In Discord: the settings of the announcements, the last number announced and the next one.

!counter announce channel

liam sets #general as the channel and Petto saves the announcements, with the next one at 2,000 — In Discord: setting the channel turns the announcements on.

!counter announce message

liam sets the message 🎉 We are {count} in {server}! and Petto shows it in the settings — In Discord: a text of your own with {count} and {server}.

!counter announce embed

liam picks the saved embed milestone and Petto shows Saved embed: milestone — In Discord: a saved embed instead of the text.

!counter announce every

!counter announce goals off

!counter announce off

!counter announce on

!counter announce test

Petto posts 🎉 We are 1,840 in Petto Land! in #general — In Discord: the message in #general, as a milestone sends it.

Dashboard

Dashboard → Integrations → Counters shows every counter with a live preview of its name, when it was last updated and when it updates next.

Packs: the same packs as !counter setup, in a gallery with the names they will show.
Order: drag the counters (or use the arrows) and Petto moves the channels in Discord to match, inside their category.
Rename: click a counter’s name to edit it with a live preview; Enter saves.
Announcements: the same settings as !counter announce, with a preview.
A small chart shows the members of the last 30 days.

Numbers and members chart

6 of 25 counters, 6 working, 1,840 members, 412 online and a line of the members of the last 30 days — Dashboard → Integrations → Counters: the counters, how many work, the members and the online members now, and the members of the last 30 days.

Packs

Order

The six counters of Petto Land, each with its name, state, last update and next update — Dashboard → Integrations → Counters: the counters with their handle and arrows to change the order.

Rename

Edit

Announcements

New counter

Members with a role that was given access to the Automation part can use this page too, see Dashboard access.

Limits

A Free server can have 25 counters and a Premium server 50. !counter create, !counter setup and the dashboard say when the limit is reached; see Premium.

liam runs !counter create bots and Petto answers that the server has the most counters it can have for free, 25 — In Discord: a Free server with 25 counters cannot make another one.

Common issues

A counter is late

It is waiting for Discord’s limit of two renames every 10 minutes. !counter list and the dashboard say when it changes next.

An online counter shows 0 or is marked with a problem

Online counts need the presences of the members. On a very big server Discord may not send every member; the counter says so.

A counter says its channel is missing

The channel was deleted, so the counter turned itself off. Delete the counter and make a new one.

Petto lists five counters; the online one cannot be renamed for lack of Manage Channels and the goal one lost its channel — In Discord: !counter list shows the problem of each counter.

A counter says Petto has no permission

Give Petto Manage Channels (in the channel and its category). The problem is reported once and shown on the counter until it is fixed.

Overview

Guides

Concepts

Moderation

Automation

Community

Roleplay

Miscellaneous

Onboarding

Setup

Resources

Common Issues

Changelog

Overview

Quick setup

Commands

Types

Names and formats

Name ideas

Where the value shows

Change a counter

Updates

Milestone announcements

Dashboard

Limits

Common issues

​Overview

​Quick setup

​Commands

​Types

​Names and formats

​Name ideas

​Where the value shows

​Change a counter

​Updates

​Milestone announcements

​Dashboard

​Limits

​Common issues

Overview

Quick setup

Commands

Types

Names and formats

Name ideas

Where the value shows

Change a counter

Updates

Milestone announcements

Dashboard

Limits

Common issues