Assign Temporary Role

Use this command to give users a role for a limited time (e.g., event winners, timeouts, temporary access).

Parameters

users (required)

Comma-separated user IDs or mentions

role (required)

The role to assign temporarily

duration (required)

How long the role lasts (e.g., 1h, 2d, 1w, 30m)

reason (optional)

Reason for assignment

Step-by-Step Example

Decide which users and role you want to assign.
Choose the duration (e.g., 7d for 7 days).

Run the command:

/assign-temp-role 
users:@User1,@User2 
role:@VIP 
duration:7d 
reason:"Event winners"

The bot will assign the role and automatically remove it after the duration.

Troubleshooting

Role not removed after duration: Ensure the bot is online and has Manage Roles permission.
User not found: Double-check user IDs or mentions.
Invalid duration: Use supported formats (e.g., 1h, 2d, 1w).

/remove-temp-role

Remove a temporary role early

/list-temp-roles

List all active temporary roles

Best Practices

Use for time-limited access or moderation actions.
Communicate to users when roles will expire.

Examples:

/assign-temp-role 
users:@User1,@User2 
role:@VIP 
duration:7d 
reason:"Event winners"

/assign-temp-role 
users:123456789012345678 
role:@Muted 
duration:30m 
reason:"Timeout for spam"