Channel counters
Display live server stats in Discord channel names with automatic updates.
Channel counters
Channel counters rename a Discord channel on a schedule to show live stats such as member count or voice occupancy. They are display-only and do not affect AttendiBot leaderboards or voice time tracking.
Setup
- Pick a voice channel to rename it for live stats, or pick a category to have AttendiBot create a new display voice channel underneath (the category name itself is not renamed).
- Lock Connect for @everyone on display voice channels so members cannot join them.
- Ensure AttendiBot has Manage Channels and View Channels.
- Open Dashboard → Counters, choose the channel or category, set a template, and save.
Counters refresh about every 6 minutes. Discord limits channel renames, so updates are intentionally batched.
Templates and placeholders
Use placeholders in curly braces. Example:
👥 Members: {members}| Placeholder | Description | Plan |
|---|---|---|
{members} | Total member count | Free |
{humans} | Human members (non-bot) | Free |
{voice_total} | Members currently in voice | Free |
{bots} | Bot count | Pro |
{boosts} | Nitro boost count | Pro |
{boost_tier} | Boost tier (0–3) | Pro |
{channels} | Channel count | Pro |
{roles} | Role count | Pro |
{voice} | Voice occupancy of the counter channel | Pro |
{voice:CHANNEL_ID} | Voice occupancy of a specific channel | Pro |
Plan limits
| Plan | Active counters | Placeholders |
|---|---|---|
| Free | 2 | {members}, {humans}, {voice_total} |
| Pro | 10 | All placeholders |
| Enterprise | Unlimited | All placeholders |
Tips
- Voice channels are renamed in place; categories create a new child voice channel for display.
- Picking a category does not rename the category header.
- Keep templates short; Discord channel names are limited to 100 characters.
{humans}and{bots}are most accurate when the bot has the Server Members privileged intent enabled.- If a counter shows an error, verify bot permissions and that the channel still exists.
Troubleshooting
| Issue | What to check |
|---|---|
| Counter not updating | Wait at least 6 minutes; confirm the counter is enabled |
| Counter disabled with permission error | Grant Manage Channels on the counter channel |
| Counter removed after channel delete | Expected — re-add the counter on a new channel |
| Name looks different from template | Output keeps your template structure; only control characters are removed and names are capped at 100 characters |
Manual test checklist
- Add a counter on a voice channel with
{members}. - Confirm the channel renames within ~6 minutes (not instantly).
- Join/leave voice and verify
{voice_total}updates on the next cycle. - Delete the channel and confirm the counter is removed from the dashboard.
- On Free, confirm a third counter or Pro placeholder is rejected.
- Remove Manage Channels and confirm the counter disables with a clear error.