Role Management

Add, remove and inspect roles for one member or many at once with the /role commands, including temporary roles.

Last updated Nov 16, 2026

Overview

The /role commands let moderators give and remove roles without opening the member list. Some work on one member, others change a whole group at once.

To use them, you need the Manage Roles permission. Cakey Bot needs Manage Roles and Embed Links, and its highest role has to be above the role you want to change.

The @everyone role cannot be used with any of these commands.

One Member

Command What it does
/role add <user> <role> Gives the role to the member.
/role remove <user> <role> Takes the role from the member.
/role temporary <user> <role> <time> Gives the role and takes it back after the time, written like 1d5h10m5s.
/role info <role> Shows the role's color, creation date, position, whether it is shown separately in the member list and whether it can be mentioned, and how many members have it.
/role listusers <role> Sends a Users.txt file with every member who has the role.

For these commands the member's highest role has to be below your highest role and below Cakey Bot's highest role. Cakey Bot does not compare the role itself with your highest role. Discord refuses a role that is above Cakey Bot's highest role, and Cakey Bot then replies that it lacks permission.

Running /role temporary again for a member who already has that temporary role removes the role and cancels the timer. Active temporary roles are listed on the Temporary Actions page of the dashboard, where you can end them early. See Muting.

Many Members

These commands change every member in a group. Members are changed one after another with a pause of 200 milliseconds between them, so a large group takes a while. The role you add or remove has to be below Cakey Bot's highest role and below your highest role, otherwise Cakey Bot refuses the command. Members whose highest role is not below Cakey Bot's highest role are skipped.

Command Who is changed
/role bulkadd-humans <role-to-add> Gives the role to every member who is not a bot.
/role bulkadd-bots <role-to-add> Gives the role to every bot.
/role bulkadd-role <role> <role-to-add> Gives the second role to every member who has the first role.
/role bulkremove-humans <role-to-remove> Takes the role from every member who is not a bot.
/role bulkremove-bots <role-to-remove> Takes the role from every bot.
/role bulkremove-role <role> <role-to-remove> Takes the second role from every member who has the first role.

Every bulk add and remove command has an optional persist option. When it is True, the change is also made on the Persistent Roles list, so it carries over when a member leaves and rejoins.

Kicking by Role

/role bulkkick <role> <confirm> kicks every member who has the role. It needs the Manage Server permission and confirm set to True. The role has to be below both your highest role and Cakey Bot's highest role, and members whose highest role is not below the bot's are skipped.

A bulk kick cannot be undone.

  • /role add Manage Roles

    Set a role on a user.

    /role add <user> <role>
  • /role remove Manage Roles

    Removes a role from a user.

    /role remove <user> <role>
  • /role temporary Manage Roles

    Set or remove a temporary role on a user.

    /role temporary <user> <role> <time>
  • /role info Manage Roles

    Displays information about the provided role.

    /role info <role>
  • /role listusers Manage Roles

    List all users that have the specified role.

    /role listusers <role>
  • /role bulkadd-humans Manage Roles

    Set a role on all humans.

    /role bulkadd-humans <role-to-add> [persist]
  • /role bulkadd-bots Manage Roles

    Set a role on all bots.

    /role bulkadd-bots <role-to-add> [persist]
  • /role bulkadd-role Manage Roles

    Set a role on all users with the given role.

    /role bulkadd-role <role> <role-to-add> [persist]
  • Remove a role from all humans.

    /role bulkremove-humans <role-to-remove> [persist]
  • /role bulkremove-bots Manage Roles

    Remove a role from all bots.

    /role bulkremove-bots <role-to-remove> [persist]
  • /role bulkremove-role Manage Roles

    Removes a role from all users with the given role.

    /role bulkremove-role <role> <role-to-remove> [persist]
  • /role bulkkick Manage Roles

    Kicks all users with the given role.

    /role bulkkick <role> <confirm>