Auto Roles

Automatic role assignment system for your Discord server. Set up join roles, tag roles, connected roles, and age-based roles.

Features

Join Roles

Automatically assign up to 7 roles to new members when they join your server.

  • Instant role assignment on member join
  • Configure up to 7 different roles
  • Perfect for welcome roles and base permissions
  • Role validation to prevent permission conflicts

Tag Roles

Reward members who adopt your server as their Discord tag with a special role.

  • Real-time detection via Discord gateway
  • Automatic role assignment/removal on tag change
  • Bulk sync for existing members with tag
  • Great for server loyalty programs

Connected Roles

Chain roles together so having specific roles automatically grants others.

  • Set up to 5 connected role assignments
  • Require 1-7 roles to grant a target role
  • Optional bulk sync for existing members
  • Perfect for role hierarchies and permissions

Age Roles (Timed Roles)

Assign roles to new members that automatically expire after a set duration.

  • Configure up to 5 age-based roles
  • Duration: 1 hour to 5 years (months, days, hours)
  • Automatic expiration checking every hour
  • Great for "New Member" badges and trial periods

Command

/autoroles

Interactive dashboard for managing all automatic role settings.

Join Roles

  • Add Join Role: Select roles to auto-assign (max 7)
  • Remove Join Role: Deselect roles to remove them
  • Reset Join Roles: Clear all join roles

Tag Roles

  • Add Tag Role: Set role for tagged users
  • Remove Tag Role: Clear tag role
  • Reset Tag Roles: Clear all tag role settings

Connected Roles

  • Add Connection: Set target role and required roles (1-7)
  • Remove Connection: Delete existing role connections
  • Reset Connections: Clear all connected roles
  • Sync Option: Apply to existing members immediately

Age Roles

  • Add Age Role: Set role with duration (format: 1M 3d 1h)
  • Remove Age Role: Delete existing age roles
  • Reset Age Roles: Clear all age roles
  • Sync Option: Apply to existing members immediately

General

  • Clear Autoroles: Remove all auto-role configurations
  • List Auto Roles: View all current settings

Setup Guide

1. Set Up Join Roles

Run /autoroles and click "Add Join Role". Select up to 7 roles that should be automatically assigned to new members.

2. Configure Tag Roles

Click "Add Tag Role" and select a role to reward members who adopt your server tag. The bot will automatically sync existing tagged members.

3. Create Role Chains

Use "Add Connection" to set up role dependencies. Select a target role and 1-7 required roles. Choose whether to sync to existing members.

4. Add Age Roles

Click "Add Age Role", select a role, and enter duration (e.g., 7d for 7 days). The role will auto-expire after the set time.

How It Works

Join Roles

When a member joins the server, the bot receives a member_join event and immediately assigns all configured join roles from the database.

Tag Roles

The bot monitors Discord gateway events for member updates. When a member's tag changes, it checks if the tag matches the server and assigns/removes the tag role accordingly.

Connected Roles

When a member receives a role, the bot checks if that role is a "required role" in any connected role setup. If the member has ALL required roles for a connection, the target role is assigned.

Age Roles

Age roles are stored with expiration timestamps. A background task runs every hour to check for expired roles and removes them automatically. When a new member joins, age roles are assigned with calculated expiration times.

FAQ

Can I combine multiple auto-role features?

Yes! You can use join roles, tag roles, connected roles, and age roles all together. For example, you can set up join roles for instant access, age roles that expire after a week, and connected roles for role progression.

What happens if I delete a role that's configured?

The bot automatically cleans up deleted roles from its configuration. If a role is deleted from Discord, it will be removed from all auto-role settings.

Can I sync existing members with new settings?

Yes! For tag roles, connected roles, and age roles, you can choose to sync existing members when setting them up. This will apply the role to all eligible members who are already in the server.

What's the difference between age roles and temporary roles?

Age roles are automatically assigned to new members and expire after a set time. Temporary roles (in Role Management) can be assigned to any specific member at any time with a custom duration.