Skip to content

Permission keys reference

Every permission key that can be assigned to a Team Role.

How keys work

  • Each key is a string like automod.view or moderation.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.
  • .edit permissions imply .view of the same group (no need to grant both).
  • moderation.edit implies every per-action moderation.<action> key.

Module group permissions

Each entry has <group>.view (see the dashboard page) and <group>.edit (change settings + take actions).

GroupWhat it covers
guildGuild Settings, Custom Branding, Logging
error_logError Log page
moderationCases & Warnings, User Lookup, Cross-Server Sync
automodAutomod rules + categories
securityAll 13 security pages
communityWelcome, Reaction Roles, Join Roles, Role Persistence, Temp Roles, Temp Channels, Channel Stats, Invites, Scheduled Messages
levellingXP, Level Roles, Leaderboard, XP Blacklist
engagementGiveaways, Polls, Suggestions, Reviews
economyWallet settings, ledger, leaderboard
casinoBlackjack, Slots, Roulette tunables
ticketsPanels, Types, Auto-Assist knowledge bases
panelsInteractive Panels builder
partnershipsPartner approval queue
fivemFiveM integration
custom_commandsServer-defined slash commands
embedsEmbed Builder
triviaTrivia rounds + schedule
countingCounting channels
custom_brandingWhite-label bot tokens
server_templatesSnapshot / apply layouts

Per-action moderation permissions

Beyond moderation.view and moderation.edit, these fine-grained keys gate individual mod actions:

KeyGates
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_editDashboard 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

KeyGrants
team_roles.manageEdit 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.

Phantom is a product of Hydra Labs. The bot is run as a managed service; you do not need to host it yourself.