Counters

Counter channels display live server statistics (member count, boost count, etc.) as voice, text, or category channel names. They update automatically every 10 minutes and provide a clean way to showcase server stats in the sidebar.

Quick Reference

Command	Description	Permission	Cooldown
`.counter add`	Create a new counter channel	Admin	5s
`.counter remove`	Remove a counter channel	Admin	5s
`.counter list`	List all counter channels	Admin	5s
`.counter template`	Update a counter's display template	Admin	5s
`.counter update`	Force-refresh all counters now	Admin	5s
`.counter types`	Show available counter types	Admin	5s

Aliases: counters, count

Creating a Counter

.counter add <type> [--template "..."] [--channel voice|text|category]

Flags:

--template "..." — Custom display template. Must include {count}. Default: {count} <Type>.
--channel voice|text|category — Channel type to create. Default: voice.

Examples:

.counter add members
.counter add boosts --template "Boosts: {count}"
.counter add online --channel text
.counter add role:123456789012345678 --template "{count} VIPs"

The bot creates the channel automatically with the correct permissions (members cannot join voice counter channels).

Counter Types

Type	Description
`members`	Total server members (including bots)
`humans`	Human members only (excludes bots)
`bots`	Bot members only
`boosts`	Number of server boosts
`boosters`	Number of members currently boosting
`channels`	Total channels in the server
`text_channels`	Text channels only
`voice_channels`	Voice channels only
`categories`	Category channels only
`roles`	Total number of roles
`online`	Members currently online (not offline/invisible)
`role:<roleId>`	Members with a specific role

Types that count specific member states (humans, bots, boosters, online, role:) require fetching the member list and may take a moment to calculate in large servers.

Managing Counters

Remove a Counter

.counter remove <#channel>

Removes the counter record and deletes the Discord channel.

Update the Template

.counter template <#channel> <template>

The template must include {count}. Discord channel names are limited to 100 characters.

Examples:

.counter template #member-count "{count} Members Online"
.counter template #boost-count "Server Boosts: {count}"

Force Update

.counter update

Triggers an immediate update of all counter channels instead of waiting for the next 10-minute cycle.

List All Counters

.counter list

Shows all active counters with their type, current count, template, and last update time.

Limits

The number of counter channels you can create depends on your server's premium tier. Free servers have a lower limit than premium servers. Use .counter list to see your current usage and limit.

Discord rate-limits channel name changes. Counter channels update every 10 minutes to stay within these limits. Using .counter update forces an immediate refresh but should not be used excessively.

Counters

On this page