To set up Lurkr, add it from Server Settings > App Directory (or its invite link) and keep the Manage Roles permission on. Then drag its role above every role it will hand out. After that, turn leveling on, choose which channels give XP, and add role rewards and multipliers by following Lurkr's current docs at lurkr.gg/docs. When Lurkr isn't giving roles, the cause is almost always role order or permissions, not Lurkr itself.
Checked on each bot's own site or docs on 3 November 2026. We make PeakBot. Nobody paid to be in this post.
Lurkr is a leveling bot. Leveling is free, with up to 3 role rewards per level and 50 in total. The paid tier, Ultimate, costs $5/month per server. This guide covers the Discord side step by step and tells you what to set in Lurkr and in what order. For exact commands and menu names, it points you to Lurkr's own pages, because those have changed over time and older guides and videos can show steps that no longer match.
Before you start
- You need the right permission. To add an app you must own the server or have the Manage Server permission. Discord's own description of Manage Server includes adding apps to the server.
- Create your reward roles first. For example: Level 5, Level 10, Level 20, Level 40. Make them normal roles. Bots cannot assign roles that an integration manages, such as the Server Booster role or a role another bot created for itself.
- Use desktop if you can. Role ordering is easiest in the desktop app or a desktop browser. Dragging roles does not work on Discord's mobile website. If you're stuck on a phone browser, switch it to desktop mode.
Step 1: Add Lurkr to your server
- On desktop, open Server Settings > App Directory, search for Lurkr and click "Add App". You can also open the invite link from lurkr.gg, pick your server and click "Authorize".
- Keep the permissions it asks for, especially Manage Roles. If you untick it, role rewards will never work.
- Check that it arrived: go to Server Settings > Integrations > "Bots and Apps". Lurkr should also show up in the member list.
Discord's guide to using apps explains where added apps appear if you can't find it.
Step 2: Move Lurkr's role above your reward roles
This is the step that most setup guides skip, and it's why most role rewards fail.
- Open Server Settings > Roles.
- Find the role named after Lurkr (Discord creates it when the bot joins).
- Drag it above every role you plan to give as a reward.
- Save.
The rule comes from Discord, not Lurkr: a bot can only assign roles that sit below its own highest role, and only if it has Manage Roles. If your Level 40 role sits above Lurkr's role, nobody will ever get it, even though the level-up message still posts.
If you mostly run your server from your phone, our guide to reaction roles on Discord mobile covers working with roles in the mobile app.
Step 3: Make sure Lurkr can see your chat channels
A leveling bot can only count messages in channels it can read. In private or locked channels, open Edit Channel > Permissions and check that Lurkr's role (or a role it has) is allowed to View Channel. If it can't see a channel, messages there earn nothing.
Step 4: Turn leveling on and choose XP channels
Follow the server leveling setup guide at lurkr.gg/docs to switch leveling on. Then decide how you'll handle channels. Leveling bots usually offer two modes:
- Block list: every channel gives XP except the ones you list. Good for most servers. Block bot-command channels, counting channels and spam channels.
- Allow list: only the channels you list give XP. Good if you want XP from one or two main chats only.
Check which mode you're in. An allow list with no channels in it means nobody earns XP anywhere, which is a common cause of "leveling is on but nothing happens."
Step 5: Add role rewards
Plan the ladder before you add anything. On Lurkr's free plan you get up to 3 role rewards per level and 50 in total, which is plenty for most servers. A simple ladder:
| Level | Reward role | Purpose |
|---|---|---|
| 5 | Regular | Unlocks image posting or reactions |
| 10 | Active | Unlocks a members-only chat |
| 20 | Veteran | Cosmetic colour |
| 40 | Legend | Cosmetic colour, top of the list |
Decide one thing first: should rewards stack (members keep Regular when they reach Active) or replace (they lose the old one)? If lower rewards unlock channels, stacking is usually safer. Otherwise people can lose access when they level up. Set this in Lurkr's role reward options, which its role rewards guide covers. If members leave and rejoin, check Lurkr's docs for how rewards are restored.
Step 6: Set XP multipliers
Multipliers change how fast XP comes in. Common uses:
- Channel multipliers: a bit more XP in your main discussion channel and less in an off-topic channel, so people talk where you want them to.
- Role multipliers: a small boost for supporters or boosters as a thank-you.
Keep them small. A large multiplier on one role turns the leaderboard into a list of who has that role. Lurkr's multipliers guide on lurkr.gg/docs has the current steps. Check Lurkr's site to see which plan includes what.
Step 7: Check what Lurkr offers for voice XP
Many people expect voice XP and go looking for it. Posts around the web, ours included, have described Lurkr's voice XP differently over time. Rely on what you actually see in Lurkr's live dashboard and its changelog at lurkr.gg/docs. If there's no voice leveling setting there for your server, voice time won't earn XP.
Step 8: Confirm it works
Ask a moderator to chat in an XP channel until they reach your first reward level. Then open their profile and check that the role appeared. If the level-up message posted but the role didn't, go back to Step 2.
How PeakBot does leveling
If you want leveling inside a bot that also runs welcomes, tickets, verification and auto moderation, PeakBot's leveling is set up on the web dashboard.
- Sign in at peakbot.pro, pick your server and open XP & Leveling in the sidebar.
- Set message XP, the cooldown and the session cap, then add level roles and a level-up message. These are on the Free plan.
- On a paid plan (Starter is $5.75/month or $48/year per server), you can also set custom voice XP rates and turn on per-channel and per-role multipliers, XP decay, and import and export of the leaderboard. Resetting the leaderboard is available too.
- The same rule from Step 2 applies: drag PeakBot's role above your level roles in Server Settings > Roles.
To be straight about it: if all you need is message leveling and role rewards, Lurkr's free plan covers that, and you don't need to pay for multipliers on PeakBot. PeakBot makes more sense when you'd rather manage leveling alongside your other server tools in one dashboard, or when you want voice XP in the same bot. PeakBot has no music or economy features. New to it? Start with Getting started. If you're building a server from scratch, our gaming server template shows where leveling fits in a full layout.
Frequently Asked Questions
Why is Lurkr not giving roles when people level up?
Check three things in this order. First, Lurkr's role must sit above the reward role in Server Settings > Roles. Second, Lurkr needs the Manage Roles permission. Third, the reward role can't be managed by an integration, such as a booster role or another bot's role. Fix those and new level-ups will give the role. Members who levelled before the fix may need their role synced or added by hand. Lurkr's troubleshooting page covers this.
Does Lurkr give XP in voice channels?
Check Lurkr's live dashboard and changelog at lurkr.gg/docs. Accounts online disagree, so go by what Lurkr itself shows for your server. If there's no voice setting, voice time doesn't count.
How do I make only one channel give XP?
Put channels in allow-list mode and add just that one channel. Remember that an empty allow list means no XP anywhere. Also check that Lurkr can view that channel.
Can I import my MEE6 levels into Lurkr?
Check the import section of Lurkr's docs before you remove your old bot. The list of bots you can import from has changed over time. Keep MEE6 in the server until the import has finished and the leaderboard looks right.
How do I stop people losing their old role reward when they get a new one?
Set role rewards to stack instead of replace in Lurkr's role reward settings. That way members keep Regular when they reach Active.
Why is no one getting XP even though leveling is on?
The usual causes: the channel list is in allow-list mode with nothing in it, Lurkr can't see the channels people talk in, or people are chatting faster than the XP cooldown, so only some messages count. Fix the channel list first. It's the most common cause.
