Roles
,role
Toggle roles on members, mass-assign, create and edit roles, restore after ban, kick, or leave.
Examples on this site start with a comma. Your server can use a different prefix. Change it with `,prefix` or in Basics if you own the server.
Who can run it
Manage Roles
Usage
,r <user|id> <role[,role]>
,r all <role>
,r humans <role>
,r bots <role>
,r create <name> [#hex]
,r delete <role>
,r color <role> <#hex>
,r rename <role> <name>
,r hoist <role>
,r mention <role>
,r info <role>
,r add <user> <role[,role]>
,r remove <user> <role[,role]>
,rr <user>
,r rs|restore <user>
Aliases
,r
Examples
,r @user member
,r @user member,pic
,r all member
,r create vip #c4a35a
,r delete vip
,r color @vip #ff0000
,r rename vip elite
,r hoist vip
,r mention vip
,r info vip
,r add @user vip,pic
,r remove @user vip
,rr @user
,r restore @user
Subcommands
- toggle. Adds each role if missing, removes it if already held. Comma-separated multi-role works.
,r <user> <role[,role]>
- all. Gives the role to every member who does not already have it. Skips hierarchy failures. `,r humans` skips bots. `,r bots` is bots only.
,r all <role>
- create. Creates a role under display roles when possible. Optional hex color.
,r c|create <name> [#hex]
- delete. Deletes a manageable role.
,r d|delete <role>
- color. Sets a solid role color.
,r col|color <role> <#hex>
- rename. Renames a role.
,r rn|rename <role> <name>
- hoist. Toggles display separately in the member list.
,r h|hoist <role>
- mention. Toggles whether anyone can mention the role.
,r m|mention <role>
- info. Shows id, color, hoist, mentionable, and member count.
,r i|info <role>
- add / remove. Force-add or force-remove without toggling.
,r a|add · ,r rm|remove <user> <role[,role]>
- restore. Restores roles saved when the member was banned, kicked, or left. They must be back in the server. Prefer `,rr`.
,rr <user> · ,r rs|restore <user>
What it looks like
near APP
,help role
Toggle roles on members, mass-assign, create and edit roles, restore after ban, kick, or leave.
,r <user|id> <role[,role]>
Notes
- Short aliases: `,r` for `,role`. Prefer `,rr <user>` for restore (also `,r rs` / `,r restore`).
- Other subcommand aliases: `c` create, `d` delete, `col` color, `rn` rename, `h` hoist, `m` mention, `i` info, `a` add, `rm` remove.
- Bot cannot manage roles at or above its highest role, or the @everyone role.
- `,r all` is slow on large servers because it walks every member safely.
Related commands
,displayrole
Creates a hoisted display role near the top of the list. Does not auto-assign.
,inrole
List everyone who has a role: mention, name, or id.
,autorole
Roles given automatically on join.
,verify
Repost the verify panel, web link, or gate sticky in the channel you already configured.
,vanity
Reward members who put this server's tag or invite in their status. The role is removed when they take it out.
,boosterrole
Boosters create a personal hoisted role under a staff-set base. Unboost deletes it. Award is a separate role given while boosting.