BuildcordDocs

Edit a role

Rename a role, or change its colour, its permissions or whether it can be mentioned.

role.edit changes a role. Anything left empty, or set to Unchanged, stays as it is.

Settings

SettingWhat it does
RoleThe role to change.
New nameIts new name.
Colour#RRGGBB.
Shown apartYes, No or Unchanged.
Anyone can mention itYes, No or Unchanged. Making a role mentionable is how members get to ping it.
PermissionsWhen given, these replace the role's permissions.
Audit log reasonThe reason Discord records.

Ways out

out. Turn on If it fails for a red way out.

Notes

  • The bot needs the Manage Roles permission, and the role must sit below the bot's highest.

Example

A /color command with a text option: change the member's own colour role to {option.hex}.

On this page