Skip to main content

temprole personal_role - Personal Temporary Role

Command​

/temprole personal_role

Description​

This command is used to manually assign a Discord role with an expiration time to a specific member.

This does not affect the role's settings itself; it only makes this assignment temporary for this specific member. Once the time is up, RoleTimer Bot will automatically remove the role from the member.

Usage​

/temprole personal_role <member> <role> <end_time> [next_role]

Parameters​

Required Parameters​

  • <member>: Select the member to add the role to. (Enter ID or @mention)
  • <role>: Select the Discord role to assign.
  • <end_time>: Set the end time. Format: YYYY-MM-DD HH:MM (e.g. 2026-05-20 12:00).
    • Limit: Free version max 30 days, Premium unlimited.

Optional Parameters​

  • [next_role]: The Discord role to automatically assign to the member after expiration.

Examples​

Example 1: Give @Tom the @VIP role valid for 3 days.

/temprole personal_role member:@Tom role:@VIP end_time:3d

Example 2: Give @Jerry the @Muted role for 6 hours, then give him the @Probation role after expiration.

/temprole personal_role member:@Jerry role:@Muted end_time:6h next_role:@Probation

Premium Features​

  • Creation Limit: Free version limit 30 personal temporary role records, Premium unlimited.
  • Duration: Free version max 30 days, Premium unlimited.
  • Next Role: Not supported in Free version, supported in Premium.

Notes​

  • One-time Operation: This command targets a "person", not a global configuration for a "role".
  • Status Check: You can use the /profile command to check a member's current personal temporary role status.

FAQ​

  • Q: Can I add multiple temporary roles to the same person? A: Yes. RoleTimer Bot will record the expiration time for each role separately.