Skip to main content
A personal role belongs to one member, who names it, colors it, and picks its icon themselves. boosterrole gives that to everyone currently boosting the server. customrole gives the same thing to members an administrator picks by hand.
Both need Manage Roles for Bloom, and Bloom’s own role must sit above the roles it creates.

​
Choosing between them

Both give a member exactly one role, and both offer the same set of controls once created.

​
Setting it up

1

Turn the feature on

Run !boosterrole enable. Until an administrator does this, boosters cannot create anything.
2

Set a base role

Run !boosterrole base @Members. New personal roles are created directly above that role, which keeps them below your staff roles.
3

Check Bloom's position

Bloom’s role must sit above the base role, or it cannot create, recolor, or clean up personal roles.
​
Administrator
Turns booster roles on or off for the whole server. Off until you enable it.
​
Administrator
Sets the role that new booster roles are positioned directly above.
​
Administrator
The same setting for custom roles.
Bloom can only manage roles below its own. If Bloom’s role slips beneath the personal roles it created, it cannot recolor them, and it cannot delete them when someone stops boosting. Keep Bloom above the base role in Server Settings → Roles.

​
Creating and editing a role

These are the member’s own commands. They work the same for boosterrole and customrole.
​
Booster
Creates the member’s personal role. Alias: brole.
  • One role per member. Delete the old one before making another.
  • Names can be up to 100 characters, and multiple words do not need quotes.
  • !boosterrole create Moonlight #7f5fff makes a role called Moonlight in that color.
​
Booster
Changes the color. Accepts a hex code, a plain description such as sunset orange, or two colors for a gradient.
  • !boosterrole color #ff5500 #00ff55 sets a gradient between the two.
  • !boosterrole color red to blue does the same from a description.
​
Booster
Renames the role, up to 50 characters.
​
Booster
Sets a role icon from a unicode emoji, a custom emoji, an image URL, or an uploaded image.
  • Your server must be at Boost Level 2, which is Discord’s own requirement for role icons.
  • Uploaded images are limited to 256 KB.
​
Booster
Shows the member’s current role with its name, color, and icon.
​
Booster
Deletes the member’s own role. They can create a new one afterwards.

​
What happens when someone stops boosting

Bloom takes the personal role off the member and deletes the role itself. It also sweeps for stale roles when it starts up, clearing any belonging to members who stopped boosting or left while it was offline.
Administrators keep their booster role after they stop boosting, so staff testing the feature do not lose their role.

​
Custom roles for members who do not boost

customrole is the same feature for members chosen by an administrator. Use it for long-standing members, event winners, or perks you grant by hand.
​
Administrator
Controls who may create a custom role. Aliases: crole, cr.
​
Administrator
Lists every custom role in the server and who holds it.
​
Whitelisted member
The same controls as boosterrole, for members on the whitelist.
  • !customrole create My Cool Role royal blue creates it.
  • Administrators can always use these commands, whitelisted or not.
A custom role is never removed automatically, because it was never tied to boosting. Take one away by removing the member from the whitelist and deleting the role.

​
Troubleshooting

boosterrole is only for members currently boosting. Use customrole with a whitelist to give the same feature to people who are not boosting.
The feature is off until an administrator runs !boosterrole enable. Bloom also needs Manage Roles.
Role icons need the server to be at Boost Level 2. Below that Discord does not accept an icon on any role, and uploads must be under 256 KB.
Bloom could not delete it, which happens when the role sits at or above Bloom’s own highest role. Move Bloom up and it clears the leftovers on its next restart. Administrators keep their roles on purpose.
Set a base role with !boosterrole base @Role. New roles are created directly above it.
Each member gets one. Run !boosterrole delete first, then create the new one.

Booster messages

Announcing each new boost in a channel.

Managing roles

Creating and positioning roles by hand.

Permissions and hierarchy

Why Bloom’s role position decides what it can manage.

Autoroles

Roles handed out automatically on join.