AkuWorks Logo

AkuWorks

Role Management

Role Management

Configure Discord roles for your verification system. Learn about verified and unverified roles, permissions setup, and automatic role assignment.

Quick Role Setup

AkuWorks can automatically create and configure verification roles for you.

Verification Roles

@Verified

Assigned to users who complete verification successfully

Auto-Assigned

Typical Permissions:

  • View all channels
  • Send messages
  • Add reactions
  • Use voice channels
  • Connect to voice

@Unverified

Temporary role for new members before verification

Auto-Assigned

Typical Permissions:

  • View verification channel only
  • Read verification instructions
  • Cannot send messages (except verification)
  • No voice channel access

@Moderator

Optional role for managing verification settings

Typical Permissions:

  • Manage verification settings
  • View verification logs
  • Manual verification override
  • Access admin commands

Permission Templates

Choose a permission template based on your server's security needs and size.

Basic Server

Simple setup for small communities

@Verified Permissions

  • View Channels
  • Send Messages
  • Add Reactions

@Unverified Permissions

  • View #verification only
Servers with < 100 members

Standard Server

Balanced permissions for most servers

Recommended

@Verified Permissions

  • View Channels
  • Send Messages
  • Add Reactions
  • Use Voice
  • Embed Links

@Unverified Permissions

  • View #verification and #rules only
Servers with 100-1000 members

Secure Server

Strict permissions for high-security servers

@Verified Permissions

  • View Channels
  • Send Messages
  • Add Reactions

@Unverified Permissions

  • View #verification only
  • Cannot react
Servers with 1000+ members or high security needs

Manual Role Setup

If you prefer to set up roles manually, follow these step-by-step instructions.

1

Create @Verified Role

  1. Go to Server Settings → Roles
  2. Click "Create Role" and name it "Verified"
  3. Set role color (recommended: green)
  4. Configure permissions based on your template choice
  5. Save the role
2

Create @Unverified Role

  1. Create another role named "Unverified"
  2. Set role color (recommended: yellow/orange)
  3. Configure restrictive permissions
  4. Ensure this role is below @Verified in hierarchy
3

Configure Channel Permissions

  1. Set @Unverified to only view verification channel
  2. Allow @Verified to access all appropriate channels
  3. Deny @everyone default permissions
  4. Test permissions with a test account
4

Configure AkuWorks

  1. Open AkuWorks dashboard
  2. Select your server
  3. Configure role assignment settings
  4. Enable auto-role assignment
  5. Test the verification process

Auto-Assignment Configuration

Assignment Triggers

New member joins→ @Unverified
Verification completed→ @Verified
Verification completed→ Remove @Unverified

Configuration Options

Auto-assign on join
Remove old roles
Preserve existing roles
Log role changes

Role Management Best Practices

Clear naming: Use descriptive role names like @Verified and @Unverified
Color coding: Use green for verified, yellow/orange for unverified roles
Minimal permissions: Start with restrictive permissions and add as needed
Regular review: Periodically review and update role permissions
Test thoroughly: Always test role assignments with a test account

Common Role Issues

Roles not being assigned:

Check bot permissions and role hierarchy. Ensure AkuWorks role is above target roles.

Users can't see channels after verification:

Verify channel permissions for @Verified role and ensure @everyone permissions are properly configured.

New members not getting @Unverified role:

Check auto-assignment settings in dashboard and ensure bot has "Manage Roles" permission.

Next Steps

After configuring roles, set up verification channels and test the system: