Auto-Roles
Automatically assign roles to new members based on customizable conditions and triggers.
Overview
Auto-roles allow you to automatically assign one or more roles to members when they join your server. This is perfect for giving all new members a default role, or assigning specific roles based on their account age or other criteria.
Configuration Commands
Use these commands to set up and manage auto-roles:
/auto-role add <role> | Add a role to the auto-role list |
/auto-role remove <role> | Remove a role from the auto-role list |
/auto-role list | View all configured auto-roles |
/auto-role enable | Enable auto-role assignment |
/auto-role disable | Disable auto-role assignment |
/auto-role delay <seconds> | Set delay before assigning roles |
/auto-role account-age <days> | Require minimum account age |
/auto-role verified-only | Only assign roles to verified members |
/auto-role exclude-role <role> | Exclude specific roles from auto-role |
/auto-role clear | Clear all configured auto-roles |
Auto-Role Types
Default Role
Automatically assigned to all new members on join
Give everyone a basic member roleAccount Age Restricted
Only assigned if account meets minimum age requirement
Prevent new/suspicious accounts from accessing contentVerified Only
Only assigned to verified members
Ensure only legitimate members get certain rolesMultiple Auto-Roles
Assign multiple roles to the same member
Give new members several roles at onceConditional Roles
Assigned based on specific conditions
Different roles based on bot verification statusRole Assignment Conditions
Control when and how roles are assigned with these conditions:
Assign role immediately when member joins
Verify account age before assignment
Require verified Discord email
Require verified phone number
Use bot detection to filter suspicious accounts
Wait specified seconds before assigning
Advanced Features
Role Stacking
Assign multiple roles to the same member simultaneously
Add multiple roles with separate /auto-role add commandsDelayed Assignment
Wait before assigning roles to verify member legitimacy
/auto-role delay <seconds>Account Age Verification
Prevent new accounts from getting roles
/auto-role account-age <days>Role Exclusion
Prevent auto-roles from being assigned to certain users or roles
/auto-role exclude-role <role>Best Practices
- • Always place bot role above auto-assigned roles in role hierarchy
- • Use account age verification to prevent raids and bot attacks
- • Add a small delay (5-10 seconds) to verify members aren't bots
- • Create a specific "New Member" role for auto-assignment
- • Combine auto-roles with verification systems for better security
- • Exclude sensitive roles from auto-role assignment
- • Use role stacking to assign multiple roles for better organization
- • Monitor role assignment logs to catch potential issues
Common Setup Examples
Basic Member Setup
/auto-role add @MemberAssign "Member" role to all new users
Secure New Member Setup
/auto-role add @New Member | /auto-role delay 10 | /auto-role account-age 7Assign role with 10-second delay and 7-day account age requirement
Multiple Role Setup
/auto-role add @Member | /auto-role add @Verified | /auto-role add @EveryoneAssign multiple roles to each new member
Troubleshooting
Roles not being assigned
Check that auto-roles are enabled with /auto-role enable. Verify the bot has permission to manage the roles. Ensure the bot role is above the auto-assigned roles.
Only some members getting roles
This may be due to account age requirements or verification conditions. Check your auto-role settings with /auto-role list to see active conditions.
Roles removed after assignment
Another system may be managing the role. Check moderation logs and other bot configurations that might affect role assignments.