Skip to main content
role is the staff command for everything to do with roles: handing them out, creating and editing them, and applying one to a whole group at once. A set of open commands lets any member check what a role does and who has it.
role needs Manage Roles, and both you and Bloom must rank above the role you are touching.

Giving and taking roles

Manage Roles
Toggles a role: the member gets it if they do not have it, and loses it if they do. Alias: r.
  • Separate several roles with commas: !role @Someone Member, Verified.
  • !role add @Someone Member and !role remove @Someone Member force one direction.
  • Names do not have to be exact. Type at least three letters and Bloom picks the closest match, telling you what it chose. When two roles are equally close it offers up to three buttons.
Manage Roles
Gives a returning member back the roles they had. Bloom keeps a snapshot for 24 hours after someone leaves.

Creating and editing roles

Manage Roles
Sets the small icon shown next to a role. Your server must be at boost level 2 or higher, which is Discord’s requirement for role icons.

Acting on many members at once

These act on the whole server in one go and cannot be reversed in bulk. Check the role name in Bloom’s confirmation before agreeing, since name matching is forgiving.

Checking roles

Open to every member, so people can look before asking staff.
Run !roles dangerous after any permission change. It is the quickest way to spot a role that grants more than you intended.

Troubleshooting

Bloom is talking about itself. Move Bloom’s role above the role you are managing. Discord never lets a bot touch a role at or above its own.
Your own top role is not above the one you are changing. Someone ranked higher has to make the change.
Give more of the name, or use a mention or the role ID.
Matching is deliberately forgiving, and Bloom always says which role it settled on. Use a mention or the role ID when two names look alike.

Autoroles

Give roles automatically when someone joins.

Reaction roles

Let members assign roles to themselves.

Booster and custom roles

Roles members create and style for themselves.

Permissions and hierarchy

Why role position decides what is possible.

Event logging

Record every role change in a staff channel.