Auto-Role System
Automatically assign roles to new members on join, based on tags, or by clan affiliation through the dashboard
Overview
The auto-role system automatically assigns roles to members based on configurable triggers. Navigate to Left sidebar > Auto-Role on your server dashboard to configure all settings. Three auto-role modes are available: Join Role (assigns a role when any member joins), Tag Roles (assigns roles based on user tags or identifiers), and Clan Tag (assigns a role based on clan affiliation).
Enabling the Module
Toggle the enabled switch at the top of the Auto-Role settings page to activate the module. Each sub-feature (join role, tag roles, clan tag) has its own enabled toggle, allowing you to use any combination of auto-role features.
Join Role
Automatically assign a role to every new member when they join the server:
enabled (toggle, default off): Activate the join role feature.
roleId (role picker): The role to assign to new members. Make sure the bot's role is positioned above this role in the server's role hierarchy, otherwise assignment will fail.
logChannelId (channel picker): A channel where join role assignments are logged. Each log entry shows the member who received the role and the timestamp.
enabled (toggle, default off): Activate the join role feature.
roleId (role picker): The role to assign to new members. Make sure the bot's role is positioned above this role in the server's role hierarchy, otherwise assignment will fail.
logChannelId (channel picker): A channel where join role assignments are logged. Each log entry shows the member who received the role and the timestamp.
Tag-Based Roles
Assign roles based on specific tags or identifiers in a member's profile:
enabled (toggle, default off): Activate tag-based role assignment.
logChannelId (channel picker): A channel for logging tag role assignments.
roles (list of tag-role mappings): Define mappings between tags and roles. Each mapping has:
tag (text input): The tag string to match against the member's profile.
roleId (role picker): The role to assign when the tag matches.
You can add multiple tag-role mappings. When a member's tag matches one of the configured tags, the corresponding role is automatically assigned.
enabled (toggle, default off): Activate tag-based role assignment.
logChannelId (channel picker): A channel for logging tag role assignments.
roles (list of tag-role mappings): Define mappings between tags and roles. Each mapping has:
tag (text input): The tag string to match against the member's profile.
roleId (role picker): The role to assign when the tag matches.
You can add multiple tag-role mappings. When a member's tag matches one of the configured tags, the corresponding role is automatically assigned.
Clan Tag
Assign a role based on clan tag affiliation:
enabled (toggle, default off): Activate the clan tag feature.
roleId (role picker): The role assigned to members with the matching clan tag.
logChannelId (channel picker): A channel for logging clan tag role assignments.
enabled (toggle, default off): Activate the clan tag feature.
roleId (role picker): The role assigned to members with the matching clan tag.
logChannelId (channel picker): A channel for logging clan tag role assignments.
Tips
Use the join role to give new members a base role that provides access to general channels. This is simpler than the registration system if you do not need a verification step. Combine tag-based roles with your community's team or faction system to automatically sort members. Always set up the logChannelId to monitor auto-role assignments and catch any issues. Make sure the bot's role is higher than all auto-assigned roles in the server hierarchy — role assignment will silently fail if the bot lacks permission.