Server configuration | Roles
Booster Roles
Give your boosters the ability to create and manage their own personalized roles.
Slash commands for this page
Set this up in Discord with /configure feature:Booster roles.
Use the slash version of each command below. Prefix commands keep working until March 5, 2027. What is changing
,br color→/boosterrole color,br base→/boosterrole base,br sync→/boosterrole sync,br list→/boosterrole list,boosterrole setup→/boosterrole setup,boosterrole filter add→/boosterrole filter add
,boosterrole filter remove→/boosterrole filter remove
Getting Started
Personalized booster roles allow your server's boosters to create a custom role with their own name, color, and icon. This feature is a great way to reward your most loyal community members.
Requirements
- Boost Tier 2: Your server must be at least Boost Tier 2 for this feature to be available.
- Boosting: The user must be actively boosting the server (or be the server owner).
- Bot Permission: greed requires the Manage Roles permission in your server.
- Role Hierarchy: greed's role must be above any booster roles it creates for the feature to work.
Limits
- Default limit: 50 booster roles per server.
- Premium Tier 2: 150 booster roles per server.
- Premium Tier 3: 250 booster roles per server.
- Share limit: By default, users can share their role with up to 5 people.
Enable the system
Run the
boosterrole setupcommand to enable the system in your server.,boosterrole setupSet a base role (Optional)
Use the
boosterrole basecommand to set a role that booster roles will be positioned under. This ensures boosters don't accidentally get permissions higher than intended.,boosterrole base @Member
Managing your role
Once enabled, boosters can use the following commands to manage their custom role.
Creating a role
Create your personalized role with a name. You can customize the color, icon, and other properties after creation.
,boosterrole create (name),boosterrole create greed-fan
,boosterrole create "Super Booster"Management Commands
Role Customization
Once your role is created, you can fine-tune it with these commands:
Change your role's color. Pass one hex code for a solid color, or two for a gradient.
,br color #ff0000
,br color #ff0000 #0000ffAliases: colour
Colours must be exact hex codes: #ff5500, ff5500 or 0xff5500. The two codes can be
separated by a space or a comma. Extra words after a colour are rejected.
Gradients require Enhanced Role Styles, which Discord unlocks for a server at 3 boosts , this is separate from the Boost Tier 2 requirement for booster roles themselves. Without it, greed gives the role a solid color and tells you why.
If a server later drops below 3 boosts, Discord automatically reverts gradient roles to a solid color using the first of the two codes.
In a Server Premium server, boosters can give their role Discord's holographic style, the shimmering three-colour finish.
,br color holographicAlias: holo. Without Server Premium you're shown the upgrade. If Discord hasn't unlocked Enhanced Role Styles for the server, the role gets a solid colour and greed tells you why. ,br color #ff0000 switches back to a solid colour at any time.
Staff with Manage Roles have the same options for any role: ,role color @role holographic.
Update your role's name at any time.
,br rename new nameSet a custom emoji or image as your role icon.
,br icon :emoji:Choose whether your role is displayed separately from other members in the sidebar.
,br hoist on/offSocial Features
You can grant your personalized booster role to friends!
,br share @userAdministrative Commands
Commands for server staff to manage the booster role system globally.
System Management
Set a "base" role that all booster roles will be positioned below in the hierarchy.
- Set base:
,br base @Role - Sync positions:
,br sync(Ensures all booster roles are correctly ordered below the base)
Prevent users from using specific words in their role names.
,br filter add (word),br list: Check how many booster roles exist and who owns them.
Role Limits
Control how many booster roles can exist in your server.
,boosterrole limit (max)Booster Awards
Automatically grant roles to users when they start boosting and remove them when they stop.
Grant a role to all boosters automatically.
,settings award add (role)View all roles granted to boosters.
,settings award listStop granting a specific role to boosters.
,settings award remove (role)You can also ask the dashboard assistant to add or remove award roles, for example "give boosters the Supporter role". You approve the change before it is saved. You need Manage Server, the role has to sit below your highest role and greed's, and roles with admin, ban, kick or manage permissions are refused because every booster would receive them.
Use ,boosterrole setup for the initial configuration. Remember that greed requires Manage Roles permissions to manage booster roles.
Deleting booster roles
To delete your own booster role:
,boosterrole deleteTo disable the entire booster role system:
,boosterrole disableAdvanced Sharing Features
Members can share their booster role with others and manage those shares.
See who you've shared your booster role with.
,boosterrole shares listConfigure the maximum number of people you can share your role with (server admin only).
,boosterrole shares max (max)Stop sharing your booster role with a specific member.
,boosterrole shares remove (user)Remove yourself from all booster roles that others have shared with you.
,boosterrole shares leaveAdvanced Role Assignment
Associate an existing role as a member's booster role (bypass creation):
,boosterrole include (role) (member)If a booster loses their active boost status, their booster role is automatically deleted. Make sure boosters understand this before they invest time customizing their role.
Use ,boosterrole filter add and ,boosterrole filter remove to manage a list of prohibited words for booster role names. Filters are case-insensitive and match any role name containing the filtered word.