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
- Enable the auto-roles module
- Open the "Humans" tab and add the desired roles
- Optional: open the "Bots" tab and configure roles for bot joins
- 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
- Open server settings → Roles
- Drag the TeraOne role (or your custom bot role) above all roles configured as auto-roles
- Make sure TeraOne has 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.
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.