The Guidebook

Everything Levels & Leaderboards does and how to use it — for community members climbing the board, and for creators running it.

What is it?

Levels & Leaderboards rewards members with XP for the things they already do — chatting, posting in forums, finishing course lessons, reacting to each other. XP adds up to levels, positions on weekly, monthly and all-time leaderboards, and real rewards: badges, quests, an XP shop, and automatic prizes for season winners.

It works out of the box with sensible defaults, and everything — point values, levels, rewards, anti-farming rules — can be tuned from the creator dashboard. On the Pro plan and up, it also counts activity in your Discord server and Telegram group: one community, one XP total, one ranking.

Quick start for creators

  1. Install the app from the Whop App Store and add it to your whop as an experience.
  2. Run the onboarding wizard. It opens automatically the first time you visit the dashboard: pick a goal template, confirm point values, set up your levels and choose your timezone.
  3. Publish. The leaderboard goes live for your members immediately — XP starts counting from that moment.
  4. Tell your community. The first check-ins and messages will put names on the board within minutes.
  5. Fine-tune later. Everything from the wizard can be changed any time under Rules and Levels — no restart needed.

Every setting has a sane default, so the app works before you touch a single option. The wizard is a head start, not a requirement.

The member experience

Earning XP

Members earn XP automatically for activity across the community. The default values (creators can change all of them):

ActivityXPDaily cap
Chat message220 XP
Forum post1030 XP
Reaction received120 XP
Course lesson completed1560 XP
Daily check-in5once per day
Payment25
Discord message220 XP
Discord reaction received120 XP
Telegram message220 XP

A few built-in fairness rules: chat messages have a short cooldown (5 minutes by default) and a minimum length, reacting to your own message earns nothing, and daily caps keep any single activity from dominating.

Levels & level-ups

XP accumulates into levels. Crossing a threshold triggers a level-up celebration — confetti in the app and a push notification. Level names and thresholds are set by the creator.

Leaderboards

Three boards run at once: weekly, monthly and all-time. The weekly board is topped by a visual podium showing the current top three. Weekly and monthly boards reset on schedule in the community's own timezone; all-time never resets.

Daily check-in & streaks

One tap a day earns check-in XP and extends a 🔥 streak, shown next to your name. Miss a day and the counter starts over — which is exactly why people don't miss a day.

Badges

Milestone badges appear on the leaderboard and on profiles: first XP earned, landing on the weekly podium, winning a month, plus any custom badges the creator has made.

Quests

Quests are time-boxed challenges like "post 3 times this week → 500 XP." Progress is tracked automatically, the bonus pays out instantly on completion, and weekly/monthly quests reset each cycle.

The XP Shop

Earned XP can be spent on rewards the creator stocks — a 1:1 call, a shoutout, a promo code. Promo codes are delivered instantly; other items go into a delivery queue the creator handles.

Spending is safe: buying from the shop never lowers your rank or level. Rankings are based on XP earned, not XP held.

Season rewards

Creators can attach automatic prizes to each weekly and monthly race — a promo code, free days of membership, or a custom prize. Winners receive them without anyone lifting a finger.

Your profile

Every member has a profile with their level, XP history, badges and streak — including a per-platform split showing how much XP came from Whop, Discord and Telegram.

Sharing

Members can generate a personal share card — a polished image of their rank and stats made for social posts. Creators can also enable a public leaderboard page that anyone can view without logging in; both use signed links and proper preview images so they look great when shared.

Notifications & weekly digest

Push notifications cover the moments that matter (level-ups, quest completions, rewards), and an optional weekly digest summarizes the board — who won, who's climbing, and how you did.

The creator dashboard

One tab per job. Here's what each does:

Overview
Engagement stats at a glance plus a next-steps checklist that guides you through setup.
Rules
The engine room: XP per activity, daily caps, the chat cooldown and minimum message length — with separate amounts and caps for Discord and Telegram. Also home to channel weights (scale XP per channel: memes at 0.5×, bot channels at 0×), allowlist mode (only channels with a weight above 0 earn XP; everything else — including channels created later — stays muted) and XP multiplier events (Pro+).
Levels
Name your levels and set their XP thresholds. Paid plans get unlimited levels.
Members
Search and manage members, make manual XP adjustments (with a reason, fully logged), and review suspicion flags raised by farming detection.
Badges
Manage the built-in milestone badges and create custom ones.
Quests
Configure up to six concurrent quests — pick the activity, the target and the bonus; tracking and payout are automatic.
Shop
Stock XP-shop items, set prices and stock levels, and work through the delivery queue for rewards that need a human touch.
Rewards
Attach automatic season prizes to the weekly and monthly races: promo codes, free membership days, or a custom prize.
Analytics
30-day trends (active members, XP by source, top members, shop and streak stats), a churn radar that flags members whose activity dropped 50%+ against their own baseline, engagement alerts, retention analytics, an XP economy health check, creator insights with concrete next steps, and one-click CSV exports (members, raw XP ledger, daily activity, shop redemptions).
Activity
A complete audit log — every XP award, adjustment, redemption and setting change.
Discord & TelegramPro
Connect and manage the platform integrations (see below).
Billing
Your current plan, usage against its member limit, and upgrades.

Farming detection: a daily scan looks for cap-hammering, sudden activity bursts and reaction rings. Flagged members show up on the Members tab for review — flags are advisory, never automatic punishment, and clear themselves when behavior normalizes.

Discord & Telegram (Pro)

Discord

Connect your server from the Discord tab and messages and reactions there earn the same XP, levels, quests and rewards as activity in your whop. Members are matched automatically through the Discord account on their Whop profile. If theirs is tied to a different account, the leaderboard shows a personal one-time code — they type /link <code> in your server (or DM the bot) and their Discord messages from the last 24 hours are credited retroactively.

Telegram

Setup is one command: add the bot to your group, then post /connect <code> with the code from the Telegram tab. Messages count instantly, and members link their Telegram with a single tap on the leaderboard. Your Telegram group appears in the channel list, so channel weights and allowlist mode apply to it like everything else.

Plans & pricing

Plans are sized by active members — unique members who earn at least one XP event in a calendar month.

Free$0 /moUp to 100 active members/month
Pro$29 /moUp to 1,000 active members/month
Scale$79 /moUp to 10,000 active members/month
EnterpriseCustomCustom — 10,000+ active members

Pro adds unlimited levels, XP multiplier events, and the Discord & Telegram integrations. Plan changes are handled gracefully: cancellations, refunds and chargebacks downgrade at the right moment, and XP, levels and history survive every plan change.

Good to know

  • Timezone-aware — daily caps, check-ins and weekly/monthly resets all run in the timezone you pick during onboarding.
  • The public board is opt-in — off by default; enable it for a shareable, login-free leaderboard page.
  • Manual XP is transparent — every manual adjustment requires a reason and lands in the audit log.
  • The weekly digest can be turned off — it's on by default and summarizes the week for members.
  • What's new — new features land on the changelog, and a dot appears in the app whenever something ships.