Skip to main content

temprole scheduled_role - Set Scheduled Role

Command​

/temprole scheduled_role

Description​

This command is used to set a regular Discord role as a Scheduled Role.

Unlike "Timed Roles" (based on duration), Scheduled Roles expire on a specific date and time. For example: expires on "January 1, 2026". After expiration, RoleTimer Bot will automatically remove this role from all members.

You can also set a "Next Role" to automatically assign a new Discord role to members upon expiration. Additionally, it supports an "Auto Delete" option: when the role expires, the Discord role itself is deleted from the server.

Usage​

/temprole scheduled_role <role> <end_time> [next_role] [auto_delete]

Parameters​

Required Parameters​

  • <role>: Select the Discord role to configure.
  • <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 after expiration.
  • [auto_delete]: Automatically delete this Discord role upon expiration? (Default: No).
    • Note: If "Yes" is selected, the role will be completely removed from the server when it expires.

Examples​

Example 1: Set @EventParticipant to expire on October 1, 2026 at 00:00.

/temprole scheduled_role role:@EventParticipant end_time:2026-10-01 00:00

Example 2: Set @HalloweenSpecial to expire on November 1st, and automatically delete the role from the server.

/temprole scheduled_role role:@HalloweenSpecial end_time:2026-11-01 00:00 auto_delete:Yes

Premium Features​

  • Creation Limit: Free version limit 5, Premium unlimited.
  • Member Limit: Free version limit 200 members per scheduled role, Premium limit 1000.
  • Duration: Free version max 30 days, Premium unlimited.
  • Next Role: Not supported in Free version, supported in Premium.

Notes​

  • Unified Expiration: Regardless of when members obtain this role, everyone will lose it at the same moment (the set end time).
  • Processing Delay: If a large number of members need to have their roles removed at the same time, there may be a delay in processing by the Bot.
  • Member Limit & Auto Delete: If the number of members in a single role exceeds the limit, the Bot cannot remove members one by one. You may need to manually delete the role after expiration. It is recommended to set auto_delete to Yes (True), so that even if the limit is exceeded, the Bot will delete the entire Discord role upon expiration, ensuring removal effectively.
  • Permission Level: RoleTimer Bot's role hierarchy must be higher than the target role.

FAQ​

  • Q: Can I change the end time? A: Yes. Run the command again with the new time to update it.