Bot Permissions Guide
Learn about the Discord permissions required for AkuWorks to function properly. Understand role hierarchy, security implications, and troubleshooting permission issues.
Permission Requirements
AkuWorks requires specific Discord permissions to manage verification. All permissions are used solely for verification functionality and server security.
Required Permissions
Manage Roles
Create and assign verification roles to users
Manage Channels
Set up verification channels and manage permissions
Send Messages
Send verification instructions and responses
Embed Links
Send rich embed messages with verification info
Read Message History
Access previous messages for context
Add Reactions
Add reaction buttons for verification
Use Slash Commands
Respond to slash commands
Role Hierarchy Setup
Proper role hierarchy is crucial for AkuWorks to function correctly. The bot role must be positioned above any roles it needs to manage.
Correct Role Order (Top to Bottom)
Important
If the AkuWorks bot role is below the roles it needs to manage, it won't be able to assign or remove those roles from users.
Setting Up Permissions
Verify Role Position
Go to Server Settings → Roles and ensure AkuWorks is above @Verified and @Unverified roles.
Test Permissions
Run a test verification to ensure all permissions are working correctly.
Common Permission Issues
Bot cannot assign roles
Cause: Missing "Manage Roles" permission or role hierarchy issue
Solution: Grant permission and ensure bot role is above target roles
Verification messages not sending
Cause: Missing "Send Messages" permission in verification channel
Solution: Check channel-specific permissions for the bot
Cannot create verification channel
Cause: Missing "Manage Channels" permission
Solution: Grant permission or manually create channel with proper permissions
Slash commands not working
Cause: Missing "Use Slash Commands" permission
Solution: Enable permission and re-invite bot if necessary