Roles ยท Roles
Managing roles
Give, take, create and edit roles, in bulk or one by one.
Overview
The everyday role tools. Giving a role is the sensitive one, because a role can carry powers. So the bot refuses to give a role that is above your own highest role, that has dangerous permissions (Administrator, Manage Server, Manage Roles, Manage Channels, Manage Webhooks, Ban or Kick Members, Mention Everyone), or that your server marked as forbidden. Everything is written in the role log.
Giving and taking a role
Both need the Manage Roles permission.
Add
Also fails with a friendly message if the member already has it.
/role add member:@Sam role:@Event reason:Tournament winnerGives the role to the member.
Remove
/role remove member:@Sam role:@EventTakes it away.
Creating, editing and deleting roles
You pick the colour from a list of Discord's named colours. You cannot edit or delete a role at or above your own top role.
Create
Name, position, colour, hoisted (shown separately in the member list) and mentionable.
Edit
Only the options you give change.
Delete
Looking at roles
Info shows the details of one role, including its permissions. The list shows every role with its member count, ten per page, and a dropdown to open the details of any of them.
Info
Needs Manage Roles.
List
Open to everyone.
Mass role editor
Adds and removes roles for many members at once. Choose who is targeted (humans, bots or everyone), the roles to add and to remove, and optionally mandatory roles (a member needs one) and forbidden roles (a member with one is skipped). The panel counts the members that will really change and estimates the time, about 0.3 second each. Only one run at a time per server, and you can cancel while it runs. Needs Manage Roles.
/role massOpens the editor. Start asks you to confirm the number of members first.
Forbidden roles
A list of roles that nobody should get. The bot refuses to hand them out, and if someone gets one anyway (for instance from Discord's own role menu), the bot takes it back at once. Use it for roles that carry your most dangerous powers. Needs Manage Server.
Need a hand?
Our support server is the fastest way to get help or suggest a feature.