Five values to require
Level from Levels, coin balance from the Bank, reputation points, days since joining and the verified role. Switch each value on or off for your server.
Discord Linked Roles bot: roles that require level, coins or verification
Linked Roles is Discord’s own way to gate a role behind a requirement. With BotGG connected, a role can require Level 10 or more, a coin balance, reputation, days in the server or being verified. Members connect BotGG to their Discord account once, BotGG keeps their values up to date, and Discord itself grants or removes the role.
rolesDiscord preview
/linkedroles link
Only you can see this
What you get
Discord does the checking
You add the requirement in Discord’s own role settings. Discord shows it on the role, checks it and grants the role, so BotGG never hands these roles out itself.
Values stay up to date
A level-up, a coin payment, a new verified role or leaving the server queues a new write. BotGG updates each member’s connection automatically and skips writes that wouldn’t change anything.
A preview before you save
The Preview tab shows the Discord profile connection card for you or any member, with your unsaved settings and example requirements marked as met or not met.
Members tab for staff
See who linked, which values were written and when. Sync a member now, preview their card or remove their values when something looks wrong.
Private by design
Members connect with Discord’s own consent screen and can unlink on their member page at any time. Tokens are stored encrypted, and unlinking clears the values on Discord.
How it works
Turn on Linked Roles
Open https://console.botgg.app, choose your server and turn on Linked Roles in the Community section. On the Values tab pick which values your server sends and the role that counts as verified.
Add a requirement to a role
In Discord open Server Settings → Roles → your role → Links, add BotGG as a requirement and set the rule, for example “Level at least 10”. The Setup tab walks through it in four steps.
Members connect BotGG
Members run
/linkedroles linkor open the share link from the console, approve the connection on Discord and come back to their member page.Discord grants the role
Once their values meet the rule, members claim the role from the server’s Linked Roles menu.
/linkedroles statusshows what this server sends for them.
One connection per member, one source server
Discord keeps one BotGG connection per account, not one per server. So each member’s values come from one source server: the one they linked from. If they link again from another server, their values move there, and their member page lets them switch at any time. The connection title shows the source server’s name, so everyone can see where the values come from.
Linked Roles is free on every plan. A value whose feature is off in the source server is simply not sent, and the Server Doctor points out values that can’t be met. Flows can react when a member links or unlinks.
/linkedroles link: get the button that connects BotGG from this server/linkedroles status: see whether you’re linked and what this server sends to Discord- Values: level, coins, reputation, days in the server, verified
Slash commands
Generated from the bot’s real command definitions. Full list on the commands page.
/linkedrolesDiscord Linked Roles: connect BotGG so roles can require your level, coins and more2 subcommands
/linkedroles linkGet the link to connect BotGG for Linked Roles from this server/linkedroles statusSee whether you linked and what this server sends to Discord
Step-by-step guides
How to give roles for levels on Discord (level roles setup)
Level roles step by step — how XP turns into levels, which thresholds to pick, stack vs replace, role position, restoring roles on rejoin, /levels sync and season reward roles.
Read the guideDiscord roles explained: role ideas, colors and hierarchy
How role position, permissions and colors really work on Discord, lists of role ideas for every kind of server, and how to hand roles out automatically.
Read the guideFrequently asked questions
What are Discord Linked Roles?
A Discord feature that lets a role require something from a connected app. With BotGG the requirement can be a level, a coin balance, reputation, days in the server or being verified. Discord checks it and grants the role.
How do I make a role that needs level 10?
Turn on Linked Roles and Levels in the BotGG console, then in Discord open the role’s Links settings, add BotGG and set Level to at least 10. Members who connect BotGG and reach level 10 can claim the role.
Why do my values come from another server?
Discord allows one BotGG connection per account, so values come from the server you linked from. Run /linkedroles link in the server you want, or switch the source on your Linked Roles member page.
How fast does a role update after a level-up?
BotGG queues the new value right away and writes it to Discord shortly after, at most once a minute per member. Discord then applies the role requirement on its side.
Does Linked Roles cost anything?
No. Linked Roles works on the Free plan with all five values.
Ready to level up your server?
Add BotGG for free, then switch features on in the web console.