Skip to main content

​
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.
~joinrole add humans <@role>
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.
~joinrole add bots <@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.
~joinrole 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.
~joinrole remove <humans|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).
~joinrole 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

1

Configure Autoroles

Set up roles for humans and/or bots:
~joinrole add humans @Members
~joinrole add bots @Bot
2

Verify Configuration

Check your settings:
~joinrole list
3

Automatic Assignment

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 PositionThe 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

Bot Permissions

The bot needs these permissions:
  • Manage Roles
  • View Audit Log (optional, for logging)

User Permissions

Command Requirements:
  • Manage Server — Required for all joinrole commands

​
Aliases

All joinrole commands support multiple aliases:

joinrole

Full command

autorole

Common alias

jr

Short alias

​
Troubleshooting

Problem: New members don’t receive the autoroleSolutions:
  • 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 autoroleSolutions:
  • 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 hierarchySolution:
  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” errorSolution:
  • Specify type: humans or bots
  • Correct: ~joinrole add humans @Members
  • Incorrect: ~joinrole add @Members
Problem: Bots receive the human role or vice versaSolution:
  • 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 joinedSolution:
  • 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

# Set up autorole for humans
~joinrole add humans @Members

# Set up autorole for bots
~joinrole add bots @Bot

# Check configuration
~joinrole list

​
Best Practices

1

Use Descriptive Role Names

Choose clear role names like “Members”, “Verified”, or “Bot” so you can easily identify them.
2

Position Roles Correctly

Keep autoroles low in the hierarchy so they don’t accidentally grant excessive permissions.
3

Separate Humans and Bots

Always use different roles for humans and bots to maintain organization.
4

Test After Setup

Create a test account or use an alt to verify the autorole works correctly.
5

Review Periodically

Check your autorole configuration occasionally to ensure it’s still appropriate for your server.

Welcome Messages

Greet new members with custom messages when they join

Role Management

Learn about role permissions and hierarchy management