Auto-roles

New members get the right role immediately

Auto-roles are assigned every time someone joins the server — without a Moderator needing to do anything. Humans and bots each have their own role list, so you can give automated accounts different roles than regular users.

Setup

  1. Enable the auto-roles module
  2. Open the "Humans" tab and add the desired roles
  3. Optional: open the "Bots" tab and configure roles for bot joins
  4. Save

Humans vs. bots

Discord distinguishes on join whether the account is a real user (is_bot = false) or a bot account (is_bot = true). TeraOne uses this to apply separate role lists. This way bot accounts can receive a dedicated bot role instead of the same role as regular members.

Check permissions

  1. Open server settings → Roles
  2. Drag the TeraOne role (or your custom bot role) above all roles configured as auto-roles
  3. Make sure TeraOne has the "Manage roles" permission
Discord does not allow assigning roles that are at the same level or higher than the bot's own role — even with the Manage Roles permission.

Relationship to the welcome module

The welcome module also has an "Auto-roles" tab. Both are independent configuration lists that run on the same join event. If the same role appears in both lists, it is still only assigned once. There is no priority — both lists are processed in full.

Use the auto-roles module as the single source of truth for join roles. The welcome module tab is a convenience feature for smaller servers.

Frequently asked questions

What happens if the bot is offline when someone joins?
If the bot is offline at the time of the join, the auto-role will not be assigned retroactively. Once the bot is back online, the rule only applies to new joins.
Can I configure a time delay for auto-roles?
No, the role is assigned immediately on join. If you need a delay (e.g. for verification), use the Anti-Alt module with quarantine.
How many roles can I configure per list?
There is no hard documented upper limit in the UI. Discord itself allows a maximum of 250 roles per server — in practice you will stay well below this.
Auto-roles · TeraOne Docs · TeraOne