Permissions
For LFG Hub to create channels, move members, and manage squads, it needs the right Discord permissions and a high-enough role. This page explains exactly what it needs and the one setting people most often miss.
Required bot permissions
The bot checks these permissions when it joins and warns you if any are missing:
| Permission | Why it's needed |
|---|---|
| View Channel | See channels to post and manage in them |
| Send Messages | Post LFG messages and status updates |
| Manage Messages | Keep LFG channels clean (remove stale posts) |
| Manage Channels | Create and delete squad voice channels and categories |
| Connect | Join voice channels |
| Speak | Voice presence in game channels |
| Move Members | Move players into their squad's voice channel |
| Set Voice Channel Status | Set the status line on voice channels |
It also effectively needs Manage Roles (it assigns roles such as Player and VC Comrade) and Create Instant Invite.
Recommended
Granting Administrator covers all of the above and avoids permission surprises. If your community requires least privilege, grant the specific permissions above — but be aware that a single missing permission can make voice automation fail silently.
Role hierarchy
This is the most commonly missed requirement.
If the bot does not have Administrator, its highest role must sit within the top 5 non-admin roles of your server. Discord only lets a bot manage roles and members below its own role, so if the bot's role is too low:
- it can't assign the
Player/VC Comraderoles, - it can't move members between voice channels,
…and these failures happen silently. The bot will DM the server owner a "move my role up" warning when it detects this.
Fix: open Server Settings → Roles and drag the bot's role near the top of the list.
Re-granting command access
Admin-only commands (/setup, /setup-lfg-channel) are, by default, visible only to members with Administrator. To let specific roles or members use them without giving full Administrator, go to Server Settings → Integrations → LFG Hub and adjust access per command.
Next: Configuration →