Skip to main content

Autoroles

Kakashi can automatically assign configured roles when a new account joins your server. Member autoroles and bot autoroles are configured separately, so a server can give human members one onboarding role while placing newly added bots in another.

Use the /config autorole options to view and manage the current setup.

Member vs bot autoroles​

Keep the distinction intentional:

  • the user/member configuration applies to normal Discord users;
  • the bots configuration applies to bot accounts.

This is useful for servers that want a default member role without accidentally giving the same permissions to integrations.

Discord role hierarchy​

The most common autorole problem is hierarchy. Kakashi can only manage roles that Discord allows it to manage.

A simplified role order should look like:

Kakashi's highest role
        ↓
Role Kakashi should assign
        ↓
Lower roles / @everyone

If the target role is above Kakashi's highest role, Discord rejects the assignment even when the autorole configuration itself is correct.

warning

Administrator permission does not bypass Discord's role hierarchy rules. Move Kakashi's role above every autorole it must assign.

  1. Create the role you want new users or bots to receive.
  2. Move Kakashi's role above it.
  3. Confirm Kakashi has Manage Roles.
  4. Configure the role through /config autorole.
  5. Test with the correct account type when possible.

Security tips​

Do not make a default autorole more powerful than it needs to be. Automatically assigning a highly privileged role to every new member defeats the purpose of Discord permission separation.

For bot autoroles, remember that each bot may still need its own permissions depending on what it does.

Common mistakes​

  • Configuring a user autorole and testing with a bot account.
  • Configuring a bot autorole and expecting human members to receive it.
  • Giving Kakashi Manage Roles but leaving its role below the target role.
  • Deleting/replacing the Discord role and assuming the old configuration now points to the new one.

Troubleshooting​

The role never appears​

Check that the configured role still exists, Kakashi has Manage Roles and the role hierarchy is correct.

It works for people but not bots​

Review the bot autorole configuration separately.

It worked before a role reorganization​

Moving roles can break hierarchy without changing Kakashi's saved configuration. Re-check the current order in Server Settings → Roles.