Use Boost Roles with kyo

Configure booster limits, colors, roles, channels, and premium messaging in order.

Boost Roles lets server boosters create and fully customize their own Discord role — picking a name, color, and icon that represents them. Once created, they can share the role with friends in the server.

As a server admin you control the limits — how many roles each booster can make, how many people they can share with, and what color styles are available. Premium subscribers unlock custom embed messages and JSON embed templates for the boost announcement.

Custom role namesColor & icon pickerRole sharingShare limitsCustom embed messages
1

Enable / Disable

Turn the booster module on or off before configuring anything else.

/boostroles setup status enabled:true
2

Limits

Use 0 to turn share limits off.

Role limit per user — how many booster roles a member can create.
/boostroles setup limit 3
Share limit per user — how many booster roles a member can be part of.
/boostroles setup sharelimit 0
Max users per role — how many members can share a single booster role.
/boostroles setup sharemax 5
3

Colors

Use /boostroles setup colors to configure each option below.

Enable / disable advanced styles — gradient and holographic modes.
/boostroles setup colors [enable_styles]
Allow gradient
/boostroles setup colors [allow_gradient]
Allow holographic
/boostroles setup colors [allow_holographic]
Require enhanced role colors perk
/boostroles setup colors [require_perk]
Holographic preset only
/boostroles setup colors [holo_preset_only]
Default style — Solid, Gradient, or Holographic.
/boostroles setup colors [default_style]
4

Roles

Reward role— the role boosters receive. Must be below kyo's highest role. Cannot be a bot or managed role.
/boostroles setup award role:@reward
Base role— user booster roles go under this role. Must be below kyo's highest role. Cannot be a bot or managed role.
/boostroles setup base role:@base
  • kyo's highest role must be above both the reward and base roles.
  • Neither role can be a bot role or a managed (integration) role.
Read more about Discord role hierarchy
5

Channels

  • Channel — pick where booster notifications and thank-you messages are sent.
/boostroles setup channel channel:#boost
6

Custom Message (Premium)

7

Embed JSON (Premium)

Next steps#

  • Review full command options in Commands Reference.
  • Configure related modules like Logger for audit visibility.
  • Validate role hierarchy and permissions before going live.