Color Roles
Let members pick their own Discord name color with a self-service role.
How it works
Members use /color set with a hex code to color their own display name, and /color reset to remove it. Airwavy reuses one dedicated role per member and recolors it in place rather than creating a new role for every color chosen.
Before you start
- Give Airwavy the Manage Roles permission and keep its highest role above where color roles should sit.
- Decide whether every member can use /color or only members holding specific roles.
Configure it
- Open Color Roles in the dashboard and enable it.
- Optionally set an anchor role so new color roles are created just below it, and optionally restrict /color to specific roles.
- Save, then run /color set with a test hex code such as #5865F2 as a normal member.
Role reuse and position
- Each member gets exactly one color role that Airwavy recolors on every /color set, instead of accumulating a new role per color.
- The optional anchor role sets where new color roles are created in the role list; leave it unset to use Discord's default position.
- If a member's existing color role was deleted or moved above Airwavy's highest role, the next /color set recreates it at the configured position.
Restricting who can use /color
- Leave the allowed-roles list empty to let every member use /color.
- Add one or more roles to restrict /color to members holding at least one of them.
- /color reset always works for a member who already has a color role, even if their allowed role was later removed.
Expected result
- The member receives a personal color role matching the chosen hex code, recolored in place on later changes.
- /color reset removes the member's color role.
Common errors
/color set fails or does nothing
Confirm Color Roles is enabled, the hex code is valid (for example #ff0000), the member holds an allowed role if restricted, and Airwavy has Manage Roles positioned above the color role.
Saved changes do not take effect
Reload the feature page and confirm the saved values. Then verify that the selected Discord channel or role still exists and that Airwavy can access it.
Discord reports missing permissions
Check the permission on both the server role and the target channel. Channel overwrites and role hierarchy can deny an action even when the server-level permission is present.