Leaderboards

View server rankings and compare your work time with teammates - completely opt-in and privacy-focused.

Overview

Leaderboards show top contributors in your Discord server based on total worked time. They're designed with privacy in mind and are completely opt-in.

Key principles

  • Name
    Private by default
    Description

    You don't appear on leaderboards unless you explicitly opt-in with /public.

  • Name
    Voluntary participation
    Description

    No pressure - leaderboards are for friendly competition, not mandatory tracking.

  • Name
    Fair rankings
    Description

    Based purely on worked time (excluding breaks) with no gaming possible.

  • Name
    Multiple time ranges
    Description

    View rankings for today, this week, this month, or all-time.

Privacy first

Default: Private

When you start using Clocky, you are private by default. This means:

  • You don't appear on any leaderboards
  • Other users can't see your worked time
  • Your stats remain completely private
  • Only you (and server admins) can see your statistics

Opt-in required

To appear on leaderboards, you must explicitly opt-in:

/public

This is a conscious choice - you're in control of your privacy.

Viewing leaderboards

Basic leaderboard

View the current week's rankings:

/leaderboard

Response:

🏆 Server Leaderboard (This Week)

1. 👑 @alice - 42h 30m
2. 🥈 @bob - 38h 15m
3. 🥉 @charlie - 35h 45m
4. @diana - 32h 0m
5. @eve - 28h 30m

Your rank: #2 (38h 15m)
─────────────────────
💡 Only users who opted in appear here

Different time ranges

/leaderboard range:today
/leaderboard range:week
/leaderboard range:month
/leaderboard range:all-time

What leaderboards show

  • Name
    Rank
    Description

    Position based on total worked time

  • Name
    Username
    Description

    Discord display name

  • Name
    Worked time
    Description

    Total time tracked (excluding breaks)

  • Name
    Your position
    Description

    If you're opted in, shows your rank

Opting in

Enable public visibility

Make yourself visible on leaderboards:

/public

First time response:

✅ You're now public!

You will now appear on server leaderboards.
Other users can see your total worked time.

Use /public again to opt out anytime.

Opting out

Change your mind? Run the same command again:

/public

Response:

🔒 You're now private

You will no longer appear on leaderboards.
Your statistics remain visible only to you.

Use /public again to opt in anytime.

Toggle behavior

The /public command is a toggle:

  • If private → become public
  • If public → become private

Rankings

How ranks are calculated

Rankings are based on:

  1. Total worked time for the selected time range
  2. Excluding break time
  3. Including only opted-in users

Rank tiers

Special indicators for top performers:

1st place: 👑 (Crown)
2nd place: 🥈 (Silver medal)
3rd place: 🥉 (Bronze medal)
4th+: No special indicator

Tie-breaking

If two users have the same worked time:

  • User who reached that time first ranks higher
  • Based on most recent session timestamp

Time range rankings

Each time range has independent rankings:

Today:

  • Resets at midnight
  • Shows who's working hardest today

This Week:

  • Monday to Sunday
  • Good for weekly competitions

This Month:

  • 1st to last day of month
  • Monthly performance tracking

All-Time:

  • Since server started using Clocky
  • Overall top contributors

Privacy considerations

What's visible when public

If you opt-in, others can see:

  • ✅ Your Discord username
  • ✅ Your total worked time
  • ✅ Your rank on the leaderboard

What remains private

Even when opted-in, these stay private:

  • ❌ Exact check-in/check-out times
  • ❌ Individual session details
  • ❌ Break duration
  • ❌ Session history
  • ❌ Which servers you're in

Admin visibility

Server admins can always see individual user stats regardless of opt-in status, but this requires explicit commands.

Leaderboard best practices

Healthy competition tips:

  1. Opt-in voluntarily - Don't feel pressured
  2. Focus on quality - Hours don't equal productivity
  3. Be consistent - Steady work beats sprints
  4. Take breaks - Don't sacrifice health for rankings
  5. Support teammates - Celebrate others' achievements

For teams

  • Make opt-in truly voluntary
  • Focus on team totals, not individuals
  • Use for motivation, not pressure
  • Celebrate all contributions
  • Remember: quality > quantity

Troubleshooting

Not appearing on leaderboard

Problem: You've worked but don't appear on the leaderboard.

Solutions:

  1. Check opt-in status: Run /public to verify you're opted-in
  2. Verify worked time: Run /stats range:week to confirm you have tracked time
  3. Right server: Leaderboards are per-server
  4. Time range: Check you're viewing the right time range

Rank seems wrong

Problem: Your rank doesn't match your expectations.

Check:

  1. Correct time range: Today vs week vs month vs all-time
  2. Break time: Breaks don't count
  3. Other opted-in users: Only see users who are public
  4. Recent sessions: Stats update after checkout

Want to hide rank temporarily

Problem: You want privacy for a period.

Solution: Run /public to opt-out. You can opt back in anytime with /public again.

Leaderboards and admin

Admin view

Admins don't need to rely on leaderboards. They can:

  • View any user's stats with /stats user:@username
  • See private users' statistics
  • Access detailed session information

Server management

Leaderboards help admins:

  • Identify most active contributors
  • Spot engagement trends
  • Recognize top performers
  • Monitor server activity

Next steps

View Your Statistics

Privacy & GDPR

Quick Start Guide

All Commands

Was this page helpful?