Permission keys reference
Every permission key that can be assigned to a Team Role.
How keys work
- Each key is a string like
automod.viewormoderation.kick. - A user holding a Discord role mapped to a Team Role gets the union of every matched Team Role's permissions.
'*'is the wildcard — granted automatically to server owners, Discord Administrators, and Phantom global admins. Cannot be assigned manually..editpermissions imply.viewof the same group (no need to grant both).moderation.editimplies every per-actionmoderation.<action>key.
Module group permissions
Each entry has <group>.view (see the dashboard page) and <group>.edit (change settings + take actions).
| Group | What it covers |
|---|---|
guild | Guild Settings, Custom Branding, Logging |
error_log | Error Log page |
moderation | Cases & Warnings, User Lookup, Cross-Server Sync |
automod | Automod rules + categories |
security | All 13 security pages |
community | Welcome, Reaction Roles, Join Roles, Role Persistence, Temp Roles, Temp Channels, Channel Stats, Invites, Scheduled Messages |
levelling | XP, Level Roles, Leaderboard, XP Blacklist |
engagement | Giveaways, Polls, Suggestions, Reviews |
economy | Wallet settings, ledger, leaderboard |
casino | Blackjack, Slots, Roulette tunables |
tickets | Panels, Types, Auto-Assist knowledge bases |
panels | Interactive Panels builder |
partnerships | Partner approval queue |
fivem | FiveM integration |
custom_commands | Server-defined slash commands |
embeds | Embed Builder |
trivia | Trivia rounds + schedule |
counting | Counting channels |
custom_branding | White-label bot tokens |
server_templates | Snapshot / apply layouts |
Per-action moderation permissions
Beyond moderation.view and moderation.edit, these fine-grained keys gate individual mod actions:
| Key | Gates |
|---|---|
moderation.kick | /pmod kick |
moderation.ban | /pmod ban + /pmod tempban |
moderation.unban | /pmod unban |
moderation.timeout | /pmod timeout + /pmod untimeout |
moderation.warn | /pmod warn |
moderation.case_edit | Dashboard case-edit / pin / delete |
moderation.edit is a meta-grant that implies every key above. Trial Mods who should only warn → grant moderation.warn. Senior Mods who should do everything → grant moderation.edit.
Special permissions
| Key | Grants |
|---|---|
team_roles.manage | Edit team roles themselves (including granting team_roles.manage to others — give carefully). |
Implication graph
The full implication graph is:
text
moderation.edit
→ moderation.kick
→ moderation.ban
→ moderation.unban
→ moderation.timeout
→ moderation.warn
→ moderation.case_edit
<group>.edit → <group>.view (for every group)Implications chain transitively, so if a future grant like a.edit ever implies b.edit it would also imply everything b.edit implies.
Cross-Server Sync
Team Roles can sync across a network. Synced roles arrive without a Discord-role binding; each subscriber's owner binds them to a local Discord role.
Related pages
- Team Roles — managing them
- Cross-Server Sync
