Skip to main content

📊 Leaderboard

Display a leaderboard showcasing the most active users. The leaderboard adds a competitive element by displaying the top-performing users based on XP, encouraging friendly competition and recognizing top contributors.

Overview​

Leaderboard provides:

  • Competitive Element: Friendly competition drives engagement
  • Public Recognition: Top contributors get visible acknowledgment
  • Motivation: Members strive to climb rankings
  • Transparency: Clear view of community activity
  • Automated Updates: Leaderboard refreshes automatically
  • Customizable Visibility: Public or private access control
Social Proof

Leaderboards leverage social proof and competition to drive engagement. Seeing top performers motivates others to participate more actively.

How It Works​

The leaderboard tracks and displays members based on their total XP:

  1. XP Tracking: System continuously monitors member XP
  2. Ranking: Members sorted by total XP (highest first)
  3. Display: Top members shown with their XP and level
  4. Update: Automatically refreshes at set intervals
  5. Access: Members can view via /leaderboard command

Example leaderboard display:

📊 Leaderboard

🥇 @defiants_Ryan — (level 0 | 208 XP)
🥈 @Dunkel19 — (level 0 | 175 XP)
🥉 @defiants_Oliver — (level 0 | 161 XP)
⭐ @Piotr_1978x — (level 0 | 40 XP)
⭐ @CrypxZach — (level 0 | 14 XP)
⭐ DanieldePalma — (level 0 | 13 XP)
Emoji Indicators

Top 3 positions get special emojis (🥇🥈🥉), creating prestigious recognition for top performers.

Configuration​

To access Leaderboard settings:

  1. Use the /settings command in your chat
  2. Navigate to 🏆 Gamification → 📊 Leaderboard
  3. Configure the settings below

Settings menu displays:

🔄🟢 Enabled/🔄🔴 Disabled: Activate or deactivate the XP leaderboard for this group.
Admins: Included/Admins: Excluded: Choose whether admins are included in the leaderboard.
🔓 Visibility: Public/🔒 Visibility: Private: Allow or restrict the use of /leaderboard by non-admin users.
⏱️ Update Interval: Set the interval (in minutes) for automatically updating and sending the leaderboard to the group.
📊 View Leaderboard: Display the current leaderboard in the group.

Leaderboard Settings​

Enabled/Disabled Toggle​

🔄🟢 Enabled/🔄🔴 Disabled: Activate or deactivate the XP leaderboard for this group.

  • 🟢 Enabled: Leaderboard is active and functional
  • 🔴 Disabled: Leaderboard is paused

When enabled:

  • Members can view leaderboard
  • Automatic updates occur (if interval set)
  • Rankings tracked in real-time
  • Command /leaderboard works

When disabled:

  • Leaderboard command doesn't work
  • No automatic updates
  • Rankings still tracked (for when re-enabled)
  • Data preserved
Impact of Disabling

Disabling the leaderboard stops public display and automatic updates but doesn't reset XP or rankings. Data is preserved for when you re-enable it.

Admin Inclusion​

✅ Admins: Included/❌ Admins: Excluded: Choose whether admins are included in the leaderboard.

Admins Included:

  • Admins appear in rankings
  • Compete alongside members
  • Can win top positions
  • Full participation

Admins Excluded:

  • Admins hidden from leaderboard
  • Only regular members shown
  • Fairer competition
  • Prevents admin dominance

Why exclude admins?

  • Admins often have higher activity naturally
  • May have XP bonuses or manual grants
  • Members prefer competing with peers
  • Creates fairer playing field
Recommended Setting

Most communities exclude admins from the leaderboard to ensure fair competition among members. Admins can still earn XP and levels, but won't appear in rankings.

Visibility​

🔓 Visibility: Public/🔒 Visibility: Private: Allow or restrict the use of /leaderboard by non-admin users.

Public Visibility:

  • Any member can type /leaderboard
  • Full transparency
  • Encourages competition
  • Members check rankings frequently

Private Visibility:

  • Only admins can view leaderboard
  • /leaderboard command restricted
  • Reduces status comparison
  • Less competitive pressure

Steps to change:

  1. Click 🔓 Visibility or 🔒 Visibility
  2. Bot toggles between Public and Private
  3. Setting applies immediately
Member Access

When set to Public, any member can see the leaderboard anytime. When Private, only admins have access. Most communities use Public to maximize competitive motivation.

Update Interval​

⏱️ Update Interval: Set the interval (in minutes) for automatically updating and sending the leaderboard to the group.

Purpose:

  • Automatically posts updated leaderboard
  • Keeps community aware of standings
  • Regular engagement touchpoint
  • No manual posting needed

Configuration:

  1. Click ⏱️ Update Interval
  2. Choose from preset intervals:
    • 30 minutes
    • 60 minutes (1 hour)
    • 120 minutes (2 hours)
    • 240 minutes (4 hours)
    • 500 minutes (~8 hours)
    • 1440 minutes (24 hours/1 day)
    • Other (custom)
  3. Bot posts leaderboard at chosen interval

Current setting shown:

⏱️ Update Interval: 60 (minutes)

Common intervals:

  • 30-60 minutes: Very active communities, frequent updates
  • 2-4 hours: Balanced, regular check-ins
  • 8-12 hours: Daily presence, twice per day
  • 24 hours: Once daily, end-of-day summary

What gets posted:

  • Current top members (typically top 5-10)
  • Their XP and level
  • Rank emojis for top 3
  • Timestamp of update
Posting Frequency

Too frequent updates can spam the chat. Too infrequent and members forget about the leaderboard. 60-120 minutes is ideal for most communities.

View Leaderboard​

📊 View Leaderboard: Display the current leaderboard in the group.

Purpose:

  • Manually trigger leaderboard post
  • Show current standings on demand
  • Independent of automatic interval
  • Useful for special announcements

Steps:

  1. Click 📊 View Leaderboard
  2. Bot immediately posts leaderboard in chat
  3. Same format as automatic updates

When to use:

  • Announce leaderboard feature
  • After major events
  • Before competitions
  • Weekly/monthly summaries
  • Special recognition moments
Manual vs. Automatic

Manual posts don't affect the automatic interval schedule. You can post manually anytime in addition to scheduled automatic updates.

Using the Leaderboard​

Member Access​

Viewing as a member:

  1. Type /leaderboard in the chat (if visibility is Public)
  2. Bot displays current rankings
  3. See your position and top performers
  4. Check how much XP needed to advance

What members see:

📊 Leaderboard

🥇 @User1 — (level 5 | 3800 XP)
🥈 @User2 — (level 4 | 2500 XP)
🥉 @User3 — (level 3 | 1400 XP)
⭐ @User4 — (level 2 | 800 XP)
⭐ @User5 — (level 1 | 400 XP)
⭐ @User6 — (level 0 | 200 XP)

Admin Management​

Admin capabilities:

  • View leaderboard anytime (regardless of visibility)
  • Configure all settings
  • Manually trigger updates
  • Monitor engagement trends
  • Identify top contributors

Admin insights:

  • Who are most active members?
  • Is engagement increasing?
  • Are rewards balanced?
  • Who deserves recognition?
  • Competition intensity level?

Common Use Cases​

Active Trading Community​

Scenario: High-activity crypto trading group.

Configuration:

  • Enabled: Yes
  • Admins: Excluded
  • Visibility: Public
  • Update Interval: 60 minutes
  • XP: 5 per message, 3 per reaction

Result: Competitive atmosphere, frequent updates, public rankings drive engagement.

Educational Community​

Scenario: Learning-focused group with quizzes.

Configuration:

  • Enabled: Yes
  • Admins: Excluded
  • Visibility: Public
  • Update Interval: 240 minutes (4 hours)
  • High quiz XP rewards

Result: Quiz performance prominent, less frequent updates reduce distraction.

Supportive Community​

Scenario: Friendly, less competitive atmosphere.

Configuration:

  • Enabled: Yes
  • Admins: Included (team participates)
  • Visibility: Private (reduced pressure)
  • Update Interval: 1440 minutes (daily)
  • Balanced XP rates

Result: Recognition without intense competition, supportive environment.

Event-Driven Competition​

Scenario: Special competition week.

Configuration:

  • Enabled: Yes (temporarily)
  • Admins: Excluded
  • Visibility: Public
  • Update Interval: 30 minutes (frequent during event)
  • Increased XP multipliers

Result: Intense competition, frequent updates build excitement, temporary boost.

New Community Launch​

Scenario: Building initial engagement.

Configuration:

  • Enabled: Yes
  • Admins: Excluded
  • Visibility: Public
  • Update Interval: 120 minutes
  • High initial XP rates

Result: Early members see immediate impact, competition encourages participation.

Best Practices​

Effective Leaderboard Use
  • Enable Early: Turn on when launching gamification
  • Exclude Admins: Fair competition for members
  • Public Visibility: Maximize competitive motivation
  • Balanced Intervals: 60-120 minutes for most communities
  • Recognize Winners: Celebrate top performers regularly
  • Fair XP Rates: Ensure leaderboard reflects genuine contribution
  • Seasonal Resets: Consider periodic resets for fresh competition
  • Prizes/Rewards: Tie rewards to leaderboard position
  • Announce Feature: Educate members about leaderboard
  • Monitor Trends: Use leaderboard data to understand engagement
Common Mistakes
  • Too Frequent Updates: Spams chat, annoys members
  • Private Visibility: Reduces competitive motivation
  • Admins Included: Unfair advantage demotivates members
  • No Recognition: Leaderboard without rewards feels pointless
  • Unbalanced XP: Easy farming makes leaderboard meaningless
  • Never Resetting: Same winners forever, others give up
  • Ignoring Data: Missing engagement insights from trends
  • Poor Communication: Members don't know leaderboard exists

Integration with Other Features​

Leaderboard + XP System​

Foundation of rankings:

  • XP determines leaderboard position
  • All XP sources affect rankings
  • XP rate balance crucial
  • Level display shows progression

Leaderboard + Roles​

Recognition rewards:

  • Top leaderboard earners get special roles
  • Periodic role awards (#1 monthly)
  • Prestige roles for high rankings
  • Visual distinction for leaders

Leaderboard + Quizzes​

Educational competition:

  • Quiz XP impacts rankings
  • Quiz events shake up leaderboard
  • Knowledge rewarded with position
  • Combine learning with competition

Leaderboard + Scheduler​

Automated recognition:

  • Schedule leaderboard announcements
  • Weekly/monthly summary posts
  • Coordinate with other content
  • Regular engagement touchpoints

Leaderboard + Token Gating​

Holder incentives:

  • Token holder XP bonuses
  • Separate holder leaderboard
  • Combined with main leaderboard
  • Extra recognition for holders

Advanced Strategies​

Seasonal Competition​

Create time-limited competition periods:

Season Structure:

  • 1-3 month seasons
  • Leaderboard resets each season
  • Seasonal prizes and recognition
  • Lifetime/all-time leaderboard preserved
  • Fresh competition regularly

Benefits:

  • Everyone starts equal each season
  • Prevents permanent dominance
  • Recurring excitement
  • More winners over time

Tiered Recognition​

Multiple leaderboard categories:

Categories:

  • Overall XP (main leaderboard)
  • Monthly top contributors
  • Quiz champions
  • Weekly activity
  • Lifetime achievements

Benefits:

  • Multiple ways to win
  • Different timeframes
  • Varied competition
  • More recognition opportunities

Prize System​

Reward top performers:

Weekly:

  • Top 3: Special recognition
  • #1: Temporary premium role
  • All top 10: Bonus XP

Monthly:

  • #1: Major prize (token rewards, exclusive access)
  • Top 5: Special roles
  • Top 10: Recognition badge

Seasonal:

  • #1: Grand prize
  • Top 3: Permanent recognition role
  • Top 10: Lifetime achievement badge
Prize Value

Prizes don't need to be expensive. Recognition, roles, and exclusive access are often more valuable than monetary rewards.

Engagement Analytics​

Use leaderboard data:

Track Metrics:

  • Average XP per member
  • Top performer XP trends
  • Position changes over time
  • New members entering top 10
  • Engagement increases/decreases

Make Decisions:

  • Adjust XP rates if needed
  • Identify optimal update frequency
  • Recognize exceptional contributors
  • Spot engagement problems early
  • Reward meaningful participation

Community Events​

Leaderboard-driven events:

Event Ideas:

  • "Climb the Leaderboard" week (2x XP)
  • Top 10 challenge (exclusive event for leaders)
  • "Catch the Leader" (bonus for passing #1)
  • Weekly quiz championship (quiz XP multiplied)
  • Community goals (unlock rewards at total XP milestones)

Troubleshooting​

Leaderboard not displaying?

  • Verify leaderboard is enabled (🟢)
  • Check bot has posting permissions
  • Ensure members have earned some XP
  • Test with /leaderboard command

Members can't access /leaderboard?

  • Check visibility is set to Public
  • Verify bot is responding to commands
  • Ensure command isn't blocked by filters
  • Test command yourself as admin

Automatic updates not posting?

  • Verify update interval is set
  • Check bot has posting permissions
  • Ensure bot is online and functioning
  • Review interval setting

Rankings seem wrong?

  • Verify XP is tracking correctly
  • Check for manual XP grants that may have occurred
  • Ensure XP cooldowns are working
  • Review XP earn rates

Admins appearing when excluded?

  • Double-check admin exclusion setting
  • Verify users are properly set as admins in Telegram
  • May need to toggle setting off and on
  • Test with fresh leaderboard view

Leaderboard spam concerns?

  • Increase update interval (e.g., 120 to 240 minutes)
  • Disable automatic updates, use manual only
  • Create dedicated leaderboard channel
  • Poll community for preferred frequency

Leaderboard Psychology​

Understanding why leaderboards work:

Motivation Drivers​

Competitive Members:

  • Love seeing their name on top
  • Work hard to maintain position
  • Rivalry with close competitors
  • Status and recognition important

Achievement-Oriented:

  • Personal improvement matters
  • Track own progress over time
  • Less focused on beating others
  • Satisfied by advancement

Social Comparison:

  • Curious about peer performance
  • Benchmark against others
  • Community standing awareness
  • Belong to active group

Potential Downsides​

Demotivation:

  • Far behind members may give up
  • Perception of impossibility
  • "Why bother" mentality

Solution:

  • Seasonal resets
  • Multiple categories
  • Highlight improvement, not just position
  • Recognize various contributions

Toxicity:

  • Excessive competition
  • Negative rivalry
  • Gaming the system
  • Rule-breaking for position

Solution:

  • Monitor for abuse
  • Balance competition with community
  • Celebrate good sportsmanship
  • Moderate competitive behavior
Balance Competition

A little competition is healthy. Too much becomes toxic. Monitor community dynamics and adjust leaderboard visibility/frequency if negativity emerges.

Competitive Engagement

Leaderboards tap into natural human competitiveness to drive engagement. When properly configured with fair XP rates, public visibility, and periodic recognition, they transform casual members into active, engaged contributors competing for top positions and community status!