Counter channels

A counter is a voice channel nobody joins — its name is the point. It renders a template with live data and updates itself on a schedule.

📊 1,247 members
🟢 312 online
💬 8.4k messages this week
🎵 @someone · 240k followers

Requires Manage Channels.

Creating one

!counter add

!counter add {members} members

!counter add #stats {online} online

With no channel, one is created for you. With no template, the default is {members} members +{joins_today} td.

!counter preview {members} members · {joins_week} this week

!counter add #stats {humans} humans

!counter view #stats

!counter refresh #stats

!counter list

!counter remove #stats

!counter preview resolves the template without creating anything — use it to check your syntax. Aliases: test, demo.

Variables

Counter templates use a flat variable set — no guild. or user. prefix, unlike scripting variables elsewhere. Run !counter variables to see them in Discord.

Live server state

Variable	Value
`{members}`	Total members
`{humans}`	Non-bot members
`{bots}`	Bots
`{pending}`	Members who haven’t passed screening
`{boosters}`	Members boosting
`{boosts}`	Boost count
`{level}`	Boost tier
`{online}` `{offline}` `{afk}` `{dnd}`	By status
`{channels}`	All channels
`{text_channels}` `{voice_channels}` `{thread_channels}` `{categories}`	By type
`{roles}` `{emojis}` `{stickers}`	Server assets

Historical data

These take an optional period suffix — _today, _week, _month, _year, _total:

Variable	Value
`{joins_today}`	Joins today
`{leaves_week}`	Leaves this week
`{net_month}`	Joins minus leaves this month
`{messages_year}`	Messages this year
`{voice_week}`	Voice time this week, formatted as `2h 34m`
`{voice_sessions_today}`	Voice sessions today
`{past_boosters}`	Everyone who has ever boosted

Without a suffix they default to a sensible period.

Aliases

Plenty of natural spellings work: {msgs_today}, {msg_7d}, {weekly_joins}, {yearly_messages}, {growth_30d}, {vc_week}, {left_alltime}, {member_count}, {people}. If a variable reads correctly, it probably resolves.

Formatting

Counter templates support pipes and operators:

{members|comma} members

{messages_total|human} messages

{boosts} {boosts|plural: boost, boosts}

{if: {boosts}>0 && 💜 {boosts} boosts && no boosts yet}

Counters that track an account on another platform instead of your server:

!counter tiktok #stats someone

!counter twitch #stats someone

!counter youtube #stats channelname {subscribers|human} subs

Command	Aliases	Variables
`counter tiktok`	`tt`	`{followers}` `{following}` `{likes}` `{hearts}` `{videos}` `{username}` `{nickname}` `{live}`
`counter soundcloud`	`sc`	`{followers}` `{following}` `{tracks}` `{username}`
`counter soundcloudtrack`	`sctrack`, `sct`	`{plays}` `{title}` `{artist}`
`counter twitch`	`tv`	`{views}` `{username}` `{live}` `{viewers}` `{game}` `{title}`
`counter twitter`	`x`, `tw`	`{followers}` `{following}` `{tweets}` `{media}` `{username}`
`counter instagram`	`ig`, `insta`	`{followers}` `{following}` `{posts}` `{username}` `{full_name}`
`counter youtube`	`yt`	`{subscribers}` `{username}` `{handle}`
`counter spotify`	`sp`, `so`	`{name}` `{followers}` `{monthly}`

!counter socialvars (aliases svars) lists them in Discord, optionally for one platform.

Live status

The Twitch counter is the interesting one, because {live} lets the channel change shape entirely:

!counter twitch #stream someone {if: {live} && 🔴 {viewers} watching && ⚫ twitch.tv/{username}}

Offline it advertises the channel; live it shows the viewer count. Twitch refreshes every 5 minutes for exactly this reason; the other platforms refresh every 15–60.

Update frequency

Discord rate-limits channel renames to twice per 10 minutes, per channel. Counters update roughly every 10 minutes as a result — a live view is not possible, and that’s Discord’s limit rather than the bot’s.Practical consequences:

Don’t make a counter that needs to be accurate to the second
!counter refresh forces an immediate update, but spend it wisely
Six counters cost six rename budgets — three or four is usually plenty

Some good ones

!counter add {members|comma} members
!counter add 🟢 {online} online
!counter add 📈 +{joins_week} this week
!counter add 💬 {messages_week|human} msgs/wk
!counter add 🎙 {voice_week} in vc
!counter add 💜 {boosts} {boosts|plural: boost, boosts}

Put counters in their own category at the top of the channel list, denied Connect for @everyone so nobody can join them. !counter add does this automatically for channels it creates.

Command reference

Command	Aliases	Description
`counter add [channel] [template]`	`create`, `set`	Create or update a counter
`counter preview <template>`	`test`, `demo`	Resolve without creating
`counter view <channel>`	`script`, `template`	View a channel’s template
`counter refresh <channel>`	`update`, `force`	Force an update now
`counter list`	`ls`	All counter channels
`counter remove <channel>`	`delete`, `del`, `rm`	Stop updating a channel
`counter clear`	`reset`, `purge`	Remove every counter
`counter variables`	`vars`	List template variables
`counter socialvars [platform]`	`svars`	List social variables

Every command requires Manage Channels. Group aliases: cntr, counters.

Start here

Security

Moderation

Server setup

Music & audio

Last.fm

Social

Utility

Counter channels

Creating one

Variables

Live server state

Historical data

Aliases

Formatting

Live status

Update frequency

Some good ones

Command reference

​Creating one

​Variables

​Live server state

​Historical data

​Aliases

​Formatting

​Social counters

​Live status

​Update frequency

​Some good ones

​Command reference

Creating one

Variables

Live server state

Historical data

Aliases

Formatting

Social counters

Live status

Update frequency

Some good ones

Command reference