Mass Role Commands

The Mass Role system allows you to perform bulk role updates on multiple members simultaneously using advanced filtering criteria.

Overview

Unlike standard Discord role assignments, the Mass Role system can target hundreds of members at once based on:

  • Join Date: Target members who joined before or after a specific date.
  • Role Presence: Target members who already have (or lack) specific roles.
  • Member Type: Automatically excludes bots to prevent accidental configuration issues.

Use Case

Perfect for giving users a role new people are given on join (e.g. "Server News", "Giveaways", "Members", etc.)

massrole

The primary command to launch the Mass Role assignment interface.

Usage:

/massrole

Interface Options:

  • Target Role: The role you want to assign to members.
  • Filters:
    • Joined Before/After: Use a date picker to define the cohort.
    • Has Role: Only include members who already have specific roles.
    • Missing Role: Only include members who do not have specific roles.

Permissions Required: Administrator

Hierarchy Check

The bot must have a higher role in the Discord hierarchy than the role it is trying to assign. Ensure the bot's highest role is positioned correctly in Server Settings.

Web Dashboard Integration

You can also trigger and monitor Mass Role assignments from the Core Settings page on the web dashboard.

  1. Navigate to Core Settings -> General Configuration.
  2. Click Open Mass Role Assignment.
  3. Configure your filters and click Start Mass Assignment.
  4. Monitor progress in real-time with the live status bars.

Troubleshooting

Button is disabled?

  • A mass role assignment might already be in progress. Check the status card or wait for the current job to finish.

Members not receiving roles?

  • ✓ Check the bot role hierarchy.
  • ✓ Ensure the bot has the Manage Roles permission.
  • ✓ Verify the filters are not too restrictive (e.g., conflicting "Joined Before" and "Has Role" criteria).