Percy is designed to work right out of the box with the permissions requested during the invite flow. However, different features require different levels of access — and if a required permission is missing, the related commands will either fail silently or return an error. This page explains exactly which permissions each feature area needs so you can grant the right access, whether you’re going with a simple Administrator setup or a tighter, minimal-permission configuration.
Quick Setup vs. Minimal Permissions
The easiest way to get Percy fully working is to grant it the Administrator permission during the invite flow. This gives Percy everything it needs for every feature and eliminates permission conflicts in individual channels. This is the recommended approach for most servers.
If Percy is missing a required permission, the affected command will fail. Percy will usually tell you which permission is missing in the error message — but some operations (like applying channel overwrites) may fail silently. When in doubt, check Percy’s role permissions and any channel-level overrides.
Permissions by Feature
Core (All Features)
These permissions are required for Percy to function at a basic level in any channel. Without them, most commands will not work at all.
Moderation
Temporary bans, mutes, and lockdowns are fully persistent — they will fire at the correct time even after a bot restart, as long as Percy still has the required permissions when the action is due.
Music
Leveling & Economy
Sentinel (Captcha Verification)
Channel-Level Overrides
Discord allows permissions to be overridden at the channel level. If you grant Percy a permission in its role but then deny that same permission in a specific channel’s settings, Percy won’t be able to use it there. Make sure no channel-level denies are blocking permissions Percy needs.
Channel overwrites take precedence over role permissions. If Percy seems to be missing a permission in one specific channel but works everywhere else, check that channel’s Edit Channel → Permissions settings for any explicit denies on Percy’s role.
Checking Percy’s Current Permissions
You can review what permissions Percy has at any time:
- Go to Server Settings → Roles and find Percy’s role.
- Check the Permissions tab for server-wide grants.
- In any channel, open Edit Channel → Permissions and look for Percy’s role or the
@everyone role to see channel-specific overrides.
If you need further help with permissions, join the Percy Support Server and the community will be happy to assist. 