> ## Documentation Index > Fetch the complete documentation index at: https://docs.celestia.rest/llms.txt > Use this file to discover all available pages before exploring further. # Autorole (Joinrole) > Automatically assign roles to members and bots when they join your server ## Overview The autorole system automatically assigns roles to new members when they join your server. You can configure different roles for human users and bots, making server management more efficient and ensuring proper permissions from the start. Autorole supports separate configurations for humans and bots, allowing you to organize your server automatically. *** ## Commands Set a role to be automatically assigned to human users when they join. ```bash Syntax theme={null} ~joinrole add humans <@role> ``` ```bash Example theme={null} ~joinrole add humans @Members ~autorole add humans @Verified ~jr add humans Member ``` **Parameters:** * **@role** — The role to assign (mention, ID, or name) **What It Does:** * Automatically assigns the specified role to all new human members * Replaces any previous human join role * Does not affect bots **Aliases:** `autorole add humans`, `jr add humans`\ **Permissions:** Manage Server Set a role to be automatically assigned to bots when they join. ```bash Syntax theme={null} ~joinrole add bots <@role> ``` ```bash Example theme={null} ~joinrole add bots @Bot ~autorole add bots @Bots ~jr add bots Bot Role ``` **Parameters:** * **@role** — The role to assign (mention, ID, or name) **What It Does:** * Automatically assigns the specified role to all new bots * Replaces any previous bot join role * Does not affect human members **Aliases:** `autorole add bots`, `jr add bots`\ **Permissions:** Manage Server Setting a bot role helps keep your member list organized and allows you to easily identify and manage bots. View the current autorole configuration for your server. ```bash Syntax theme={null} ~joinrole list ``` ```bash Example theme={null} ~joinrole list ~autorole list ~jr list ``` **What It Shows:** * Current role assigned to humans * Current role assigned to bots * "None" if no role is configured **Aliases:** `autorole list`, `jr list`\ **Permissions:** Manage Server Remove the autorole for either humans or bots. ```bash Syntax theme={null} ~joinrole remove ``` ```bash Example theme={null} ~joinrole remove humans ~joinrole remove bots ~autorole remove humans ~jr remove bots ``` **Parameters:** * **humans** — Remove autorole for human members * **bots** — Remove autorole for bots **What It Does:** * Disables automatic role assignment for the specified type * Does not affect the other type * Does not remove roles from existing members **Aliases:** `autorole remove`, `jr remove`\ **Permissions:** Manage Server Remove all autorole configurations (both humans and bots). ```bash Syntax theme={null} ~joinrole clear ``` ```bash Example theme={null} ~joinrole clear ~autorole clear ~jr clear ``` **What It Does:** * Removes autorole for both humans and bots * Disables the entire autorole system * Does not remove roles from existing members This removes all autorole configurations. Use `joinrole remove` if you only want to remove one type. **Aliases:** `autorole clear`, `jr clear`\ **Permissions:** Manage Server *** ## How It Works Set up roles for humans and/or bots: ```bash theme={null} ~joinrole add humans @Members ~joinrole add bots @Bot ``` Check your settings: ```bash theme={null} ~joinrole list ``` When new members join: * Human users automatically receive the configured human role * Bots automatically receive the configured bot role * Roles are assigned immediately upon joining *** ## Role Hierarchy Requirements **Bot Role Position** The bot must have a role positioned **higher** than the roles it's trying to assign. If the autorole is positioned above the bot's highest role, assignment will fail silently. **How to Fix:** 1. Go to Server Settings → Roles 2. Ensure the bot's role is above the autorole 3. Drag roles to reorder if needed *** ## Permission Requirements The bot needs these permissions: * Manage Roles * View Audit Log (optional, for logging) Command Requirements: * **Manage Server** — Required for all joinrole commands *** ## Aliases All joinrole commands support multiple aliases: Full command Common alias Short alias *** ## Troubleshooting **Problem:** New members don't receive the autorole **Solutions:** * Verify configuration with `~joinrole list` * Check bot has "Manage Roles" permission * Ensure bot's role is higher than the autorole in role hierarchy * Verify the role still exists (wasn't deleted) * Check bot is online and functioning **Problem:** "Could not find that role" error when setting autorole **Solutions:** * Mention the role: `@RoleName` * Use the role ID: `123456789012345678` * Type the exact role name (case-insensitive) * Verify the role exists in your server **Problem:** Role assignment fails due to hierarchy **Solution:** 1. Go to Server Settings → Roles 2. Drag the bot's role above the autorole 3. Save changes 4. Test with a new member joining **Problem:** "Usage: `~joinrole add humans/bots @role`" error **Solution:** * Specify type: `humans` or `bots` * Correct: `~joinrole add humans @Members` * Incorrect: `~joinrole add @Members` **Problem:** Bots receive the human role or vice versa **Solution:** * Verify configuration with `~joinrole list` * Ensure you set the correct type * Use `~joinrole remove humans` or `~joinrole remove bots` to fix * Reconfigure with correct type **Problem:** Want to remove roles from members who already joined **Solution:** * Autorole only affects new members * To remove from existing members, use role management: * Server Settings → Members * Select members → Manage Roles * Or use a bot mass role command *** ## Usage Examples ```bash theme={null} # Set up autorole for humans ~joinrole add humans @Members # Set up autorole for bots ~joinrole add bots @Bot # Check configuration ~joinrole list ``` ```bash theme={null} # Give new members a starter role ~joinrole add humans @Newcomer # Separate bots into their own role ~joinrole add bots @Bot Account # Verify setup ~joinrole list ``` ```bash theme={null} # Auto-assign gamer role ~joinrole add humans @Gamer # Mark utility bots ~joinrole add bots @Utility Bot # View current roles ~joinrole list ``` ```bash theme={null} # Change human role ~joinrole add humans @Verified # This replaces the old role # Remove bot autorole ~joinrole remove bots # Check changes ~joinrole list ``` ```bash theme={null} # View current configuration ~joinrole list # Remove humans autorole ~joinrole remove humans # Remove bots autorole ~joinrole remove bots # Or clear everything ~joinrole clear ``` *** ## Best Practices Choose clear role names like "Members", "Verified", or "Bot" so you can easily identify them. Keep autoroles low in the hierarchy so they don't accidentally grant excessive permissions. Always use different roles for humans and bots to maintain organization. Create a test account or use an alt to verify the autorole works correctly. Check your autorole configuration occasionally to ensure it's still appropriate for your server. *** ## Related Features Greet new members with custom messages when they join Learn about role permissions and hierarchy management