Role ReactorTemp Roles
Manage temporary role assignments. Assign roles that automatically expire after a set time, perfect for events, timeouts, or temporary access.
Use Cases
Suitable for:
- Event winners - Provide VIP access for a limited time
- Moderation - Temporary timeouts or restrictions
- Trial periods - Enable users to try premium features
- Special occasions - Holiday roles or celebration access
Subcommands
assign
Assign a temporary role to users
list
List all active temporary roles
remove
Remove a temporary role early
Parameters
Assign Subcommand
users (required)
Users to target (supports mentions, IDs, role mentions, @everyone)
role (required)
The role to assign temporarily
duration (required)
How long the role should last (e.g., 30m, 2h, 1d, 1w)
reason (optional)
Reason for assigning the temporary role
notify (optional)
Send DM notification when role is assigned/removed (default: false)
notify-expiry (optional)
Send DM notification when role expires (default: false)
List Subcommand
user (optional)
The user to check (leave empty for all users)
Remove Subcommand
users (required)
Users to target (supports mentions, IDs, role mentions, @everyone)
role (required)
The temporary role to remove
reason (optional)
Reason for removing the temporary role
notify (optional)
Send DM notification about role removal (default: false)
Step-by-Step Examples
- Assign a temporary role:
/temp-roles assign users:@user1,@user2 role:@EventRole duration:2h reason:Tournament participation notify:true- The bot will assign the role and automatically remove it after the duration.
Assign to multiple users with expiry notification:
/temp-roles assign users:@RoleName role:@Mute duration:5m notify-expiry:true- List all temporary roles:
/temp-roles list- List for specific user:
/temp-roles list user:@user1- Remove a temporary role early:
/temp-roles remove users:@user1,@user2 role:@EventRole reason:Early removal notify:trueUser Targeting
- User mentions -
@user1,@user2(target specific users) - Role mentions -
@RoleName(target all members with that role) - User IDs -
123456789,987654321(target by ID) - @everyone - Target all server members
- Mix formats - Combine any of the above (e.g.,
@user1,@RoleName,123456789)
Time Examples
30m- 30 minutes (suitable for quick events)2h- 2 hours (appropriate for tournaments)1d- 1 day (suitable for day-long events)1w- 1 week (for extended special access)1h30m- 1 hour 30 minutes (flexible timing)
Permissions Required
- Manage Roles: Required to assign/remove temporary roles
Troubleshooting
- Role not removed after duration: Verify the bot is online and has Manage Roles permission.
- User not found: Verify user IDs or mentions.
- Invalid duration: Use supported formats (e.g., 1h, 2d, 1w).
- Permission denied: You require Manage Roles permission to manage temporary roles.
Related Commands
Use Cases
- Events, tournaments, giveaways, VIP access
- Beta testing, temporary mutes, or any temporary special access
- Time-limited access or moderation actions
- Enable notifications to keep users informed