Utilities

Bulk Roles

Perform large-scale role assignments and removals with safety checks, preview capabilities, and reusable filter sets. Perfect for mass onboarding, cleanup, or event-based role management.

What is Bulk Roles?

Bulk Roles enables you to add or remove roles from multiple members at once using advanced filtering criteria. Instead of manually assigning roles one by one, you can target groups of members based on their attributes like join date, current roles, level, and more. Before executing any operation, you can preview changes with dry-run mode to ensure safety.

Use cases include: onboarding new members with starter roles, removing inactive roles, assigning anniversary roles, promoting members based on level thresholds, and managing role hierarchies efficiently.

Core Components

Studio Tab

The main workspace for creating and executing bulk role operations. This is where you define what roles to modify and which members are affected.

Operation Type

Select Add to grant roles or Remove to revoke them. This determines the action applied to matching members.

Target Role

Use the SearchableSelect dropdown to choose the role you want to bulk assign or remove. Only one role can be targeted per operation.

Filter Criteria

Apply multiple filters to narrow down which members are affected:

  • •Members with role X: Only affect users who already have this role
  • •Members without role Y: Only affect users lacking this role
  • •Joined before date: Target members who joined before a specific date
  • •Joined after date: Target members who joined after a specific date
  • •Level above/below: Target members with level thresholds (if levels are enabled)

Dry-Run Mode

Before executing your operation, activate dry-run mode to see exactly what changes will occur without actually applying them. This is essential for safety and verification.

When you run a dry-run:

  • SYNTHET scans all members and applies your filter criteria
  • Results show matching members without modifying their roles
  • You review the preview and decide whether to proceed
  • Execute the operation with confidence knowing the impact

Execution & Progress

When you execute an operation, SYNTHET processes all matching members and applies role changes with real-time progress tracking.

Progress Tracking

During execution, you'll see:

  • •Overall progress percentage
  • •Number of members processed
  • •Successful role changes
  • •Skipped members (already had/lacked role)
  • •Failed operations with error details

The dashboard updates live as operations progress, and a notification is sent when complete.

History Tab

View all past bulk role operations with detailed results and audit information.

Each history entry shows:

  • •Operation timestamp and duration
  • •Operation type (Add/Remove) and target role
  • •Applied count: successfully modified members
  • •Skipped count: members who didn't meet criteria
  • •Failed count: errors during execution
  • •Filters used for reproducibility
  • •Staff member who executed the operation

Click any entry to expand and see the full details or regenerate the operation with the same filters.

Smart Sets Tab

Save and reuse filter combinations to streamline repetitive bulk operations.

What are Smart Sets?

Smart Sets are saved filter combinations with memorable names. Instead of recreating complex filter criteria every time, you can save them as sets and reuse them instantly.

Example Smart Sets:

  • •"All Nitro Boosters": Members with the Booster role
  • •"Level 10+ Members": Members with level above 10
  • •"Early Joiners": Joined before a specific date
  • •"Inactive Users": Members without recent activity role

Create a set by configuring filters, clicking "Save as Smart Set", naming it, and using it repeatedly for consistent operations.

Config Tab

Configure safety limits, rate limiting, and notification preferences for bulk operations.

Rate Limiting

Control how fast SYNTHET applies role changes. Set a delay between role assignments to avoid API rate limits and spread load on your server.

Safety Limits

Configure maximum members affected per operation, maximum roles per member, and other thresholds to prevent accidental mass modifications.

Completion Notifications

Choose whether to send a notification when bulk operations complete, and specify who should be notified (server, DM, or log channel).

Audit Logging

Enable detailed audit logs for all bulk role operations, including who performed the action and what changed.

Dashboard Walkthrough

Here's a step-by-step guide to using Bulk Roles in the SYNTHET web dashboard.

Step 1: Access the Dashboard

Navigate to /dashboard/utilities and click the Bulk Roles section or card.

Step 2: Configure Your Operation

  1. ASelect Operation Type: Choose "Add" or "Remove"
  2. BChoose Target Role: Use the SearchableSelect dropdown to find and select the role
  3. CAdd Filters: Click "Add Filter" for each criterion (role presence, join date, level, etc.)
  4. DConfigure each filter with specific values (select roles, dates, or level ranges)

Step 3: Dry-Run Preview

  1. AClick the "Dry Run" button to preview changes
  2. BReview the preview showing affected members and what will change
  3. CVerify accuracy. If needed, go back and adjust filters, then dry-run again

Step 4: Execute Operation

  1. AClick the "Execute" button to apply changes (requires confirmation)
  2. BWatch the progress bar as SYNTHET processes each member
  3. CWhen complete, review the summary (applied, skipped, failed counts)

Step 5: Review History

  1. ASwitch to the History tab to see all past operations
  2. BClick any operation to view full details including filters used
  3. CUse "Repeat Operation" to run the same filters again with one click

Discord Commands

Quick access to bulk role operations directly from Discord (requires dashboard for complex setup).

/bulk-roles execute

Run a saved smart set or recent operation without opening the dashboard.

/bulk-roles history

View your last 5 bulk role operations with results summary.

Best Practices

  • • Always run dry-run first to verify the operation will affect the right people
  • • Start with conservative filters and expand gradually to avoid over-application
  • • Use Smart Sets for frequently repeated operations to save time and reduce errors
  • • Check the Config tab periodically to ensure rate limits match your server's capabilities
  • • Review operation history weekly to maintain an audit trail of all role changes

Common Use Cases

Onboarding New Members

Add starter roles to all members who joined in the last 24 hours automatically.

Seasonal Role Updates

Remove event-specific roles from everyone when an event ends.

Promotion Based on Level

Grant premium member roles to users who reach level 10 or higher.

Cleanup Operations

Remove archived or legacy roles from inactive members.

← Invite TrackerUser Profiles →