Allow members to create and personalize their own roles with custom names, colors, icons, and even share them with others.
Let members create roles with their own custom names.
Multiple color options for ultimate customization.
Add icons to custom roles for extra personalization.
Share your custom role with other members.
Configure the custom role system for your server.
Example: Set required role to "Nitro Booster", base role to "@everyone", and enable sharing.
Disable the custom role system. Existing custom roles remain but can no longer be modified.
Create or update your custom role name.
Set a solid color for your custom role.
#FF5733 or FF5733)red, cyan, purple)Set a two-color gradient for your custom role.
Apply animated holographic effect to your custom role.
Set an icon for your custom role.
Allow another member to share their custom role with you.
/customrole share to completeShare your custom role with someone who allowed you.
/customrole allow firstDelete your custom role or remove a shared role.
Run /customrole config as admin:
Members with the required role run /customrole name and enter their desired role name (max 30 characters).
Use /customrole color_solid, color_gradient, or color_holographic for colors. Add icons with /customrole icon.
If sharing is enabled, non-eligible members can use /customrole allow, then eligible members can share their roles with /customrole share.
When a custom role is created, it's positioned directly above the configured base role using Discord's API. This ensures all custom roles stay in a specific section of the role hierarchy.
Custom roles are stored in MongoDB with member ID, guild ID, and role ID. Shared roles are tracked separately to distinguish between owned and borrowed roles.
The bot verifies the required role before allowing any customization. Role icons and advanced colors check for server boosting level and features before applying changes.
Role sharing uses a two-step process: the recipient grants permission via /customrole allow, storing this in memory. The owner then uses /customrole share to complete the share, which checks permissions and assigns the role.
Reward server boosters with personalized roles as a thank you for supporting your server.
Give premium members or Patreon supporters custom role privileges for extra perks.
Award contest winners with custom roles as prizes that they can fully personalize.
Sell custom role access for a set period as a server monetization strategy.
Allow team leaders to create custom roles that they can share with team members.
Let members express their personality with unique role names, colors, and icons.
No, if you create your own custom role, any shared role you had will be removed. You can only have one or the other, not both.
Your custom role will remain, but you won't be able to modify it until you regain the required role.
Yes! A role owner can share their role with multiple members. All recipients will have the same role.
Your server needs the "Enhanced Role Colors" feature, which is a Discord experiment feature not tied to boosting level.
The bot's database entry will remain. You should use /customrole clear to properly remove the role and clean up the database.