How do token-gated roles work on Discord?
Updated · Crypto & web3
A token-gating bot (for example Collab.Land or Guild.xyz) asks members to connect a wallet on the bot's own site, checks whether that wallet holds the required token or NFT, and gives a Holder role; it re-checks periodically and removes the role if the holding is gone. Discord itself doesn't read wallets; the role simply unlocks channels like any other role.
| Step | Where | Note |
|---|---|---|
| Create Holder role | Server Settings > Roles | No special permissions; used for channel access |
| Invite the bot | Bot's official site | Grant Manage Roles; place its role above Holder |
| Set the rule | Bot dashboard | Chain, contract, minimum balance |
| Gate channels | HOLDERS category | Deny @everyone, allow Holder |
| Test | Alt account + test wallet | Join, verify, sell/move token, confirm removal |
Safety rules for members
- Only connect a wallet through the link posted in #official-links or the bot's official domain.
- Gating never needs a seed phrase or a transaction that moves funds.
- A real gating bot never DMs you first.
Multiple tiers
Create one role per tier (Holder, Whale, Founder pass) and one rule per role in the bot. Keep tier channels in separate categories so permissions stay simple.
Quick answers
- Is token gating built into Discord?
- No. It's done by third-party bots that assign roles. Discord's Linked Roles feature lets apps provide verified connections, but the wallet check is done by the app.
- Which bot should I use?
- Collab.Land and Guild.xyz are widely used. Compare supported chains and pricing on their official sites.
- What happens when someone sells?
- The bot's periodic re-check removes the role. Check the bot's re-check frequency.
What to do next
The Crypto Project template includes the HOLDERS category, Holder role and gating checklist. $49 one-time.
Related guides
Sources
Checked: . Discord changes features and menus often; if something looks different, the official help center is the source of truth. Discord Template Hub is not affiliated with Discord.