Auto Role Bot

Getting Started

1. Invite the Bot — Add Auto Role Bot to your server with the necessary permissions.
2. Position Bot Role — Ensure the bot’s role is above roles you want it to manage in Server Settings. The bot can only manage roles below its highest role.
3. Choose Features — Explore the sections below and pick what fits your server’s needs.
4. Configure & Test — Use the commands below to set up features and test before going live.

Auto Roles

Automatic role assignment for new and existing members. Configure everything through the /autoroles interactive dashboard.

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
• Auto-cleans deleted roles from config

Tag Roles

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

• Real-time detection when a member updates their tag
• Automatic role assignment when tag is adopted
• Automatic removal when tag is removed
• Bulk sync option for existing tagged members
• Requires the server to have the Guild Tags feature

Connected Roles

Chain roles together — having specific roles automatically grants or removes others.

• Up to 5 connected role configurations per server
• Require 1–7 eligible roles per configuration
• Action: add (grant target role) or remove (take target role)
• Mode: any (at least one eligible role) or all (all eligible roles required)
• Impact: two-way (reverse on role loss) or one-way (no reversal)
• Optional bulk sync for existing members

Age Roles

Assign roles after a member has been in the server for a set duration.

• Up to 5 age role configurations
• Duration format: 1M 3d 1h (Months, days, hours)
• Range: 1 hour to 5 years
• Optional sync to existing members

Timed Roles

Assign roles on join that automatically expire after a set duration.

• Up to 5 timed role configurations
• Same duration format as age roles
• Roles assigned on join, removed after duration
• Great for “New Member” badges and trial periods

/autoroles Command

Interactive dashboard for managing all automatic role settings:

• Join Roles: Add/remove join roles (max 7)
• Tag Roles: Set or clear tag role
• Connected Roles: Add, remove, or reset configurations with sync option
• Age & Timed Roles: Add with duration (e.g., 7d or 1M 3d 1h), remove, reset, or sync
• General: Clear all auto-roles, list current settings

Reaction Roles

Interactive emoji-based role assignment for self-service.

How to Set Up

1. Right-click (or long-press on mobile) any message in your server
2. Select Apps from the context menu
3. Choose Setup Reaction Role
4. Select a role from the dropdown menu
5. React to the message with your desired emoji within 3 minutes
6. The bot adds its own reaction and activates the role assignment

The bot needs “Manage Messages” permission in the channel.

Features

• Unlimited reaction roles per server
• Multiple emojis per message, across multiple messages
• Standard Unicode emojis, custom server emojis, and animated emojis supported
• Real-time role assignment on react, removal on unreact

/reactionroles Command

• Add Reaction Role: Opens instructions for the context menu setup
• Remove Reaction Role: Dropdown to remove individual reaction roles
• List All: View all reaction roles with message IDs and emoji-role mappings
• Clear All: Remove all reaction role configurations at once

Role Management

Individual and bulk role management with smart filtering via the /role command.

Individual Role Management

• /role add @member @role — Add a role to a member
• /role remove @member @role — Remove a role from a member
• /role temp @member @role <duration> — Assign a temporary role

Temporary Roles

Assign roles with automatic expiration.

• Duration format: 1M 3d 1h 8m (months, days, hours, minutes)
• Range: 1 minute to 1000 days
• Expired roles are removed automatically

Bulk Role Operations

/role bulk opens an interactive panel for mass role management:

• Target: All bots, all humans, or all members
• Mode: Add or remove
• Whitelist: Only affect members with ANY of the specified roles (up to 25)
• Blacklist: Skip members with ANY of the specified roles (up to 25)
• Member Age: Filter by how long members have been in the server
• Automatic skip if role is already assigned/removed
• Assignments are processed gradually to avoid disruption

Custom Roles

Personalized roles with custom names, colors, and icons for VIP members.

Admin Setup

/customrole config — Configure the custom role system:

• Required Role: Role users need to create custom roles (e.g., Booster, Premium)
• Base Role: Custom roles are positioned above this role
• Allow Share: Enable/disable role sharing between members
• Prefix: Optional prefix for all custom role names (max 10 characters)

Member Commands

Automatic Cleanup

• Custom role is deleted when a member leaves the server
• Custom role is deleted when a member loses the required role

Custom Channels

Private channels for VIP members via the /customchannels command.

Admin Setup

/customchannels config — Configuration panel:

• Add Role Config: Set a role and max channel count per member (1–10). Up to 6 role configs.
• Set Category: Where custom channels are created (max 50 channels per category)
• Toggle Sharing: Enable/disable channel sharing
• Set Staff Role: Staff gets access to all custom channels
• Set Prefix: Channel name prefix (max 10 characters)
• Disable System: Remove all configuration and data

Member Commands

Permissions

• Owner: Full access including manage messages
• Shared members: Same as owner
• Staff role: Same as owner plus mention everyone and embed links
• @everyone: No access

Automatic Cleanup

• Channels are deleted when the owner loses ALL required roles
• Channels are deleted when the owner leaves the server

Utility Commands

Limits