Skip to main content
1

Understanding Reaction Roles

The Reaction Roles system in Omex allows members to easily assign themselves roles from within Discord.
Instead of relying on emojis, Omex uses a built-in step system that connects a message, a role, and a user’s interaction.
This system is perfect for assigning interest roles, notification pings, or game-specific tags — all managed automatically by Omex.
2

Setting Up a Reaction Role

Admins can create a reaction role configuration by linking a message to a role directly through commands.
reactionrole add <#channel> <messageID> <@role>
  • Description: Links a message to a role. When users interact with that message using Omex’s built-in system, they’ll receive or remove the linked role.
  • Example: 
    reactionrole add #roles 123456789012345678 @Gamer
Once configured, Omex will automatically manage interactions for that message — users can self-assign or remove roles directly through its interface.
3

Removing a Reaction Role

To remove an existing role link from a message, use:
reactionrole del <#channel> <messageID>
  • Description: Deletes a linked role configuration from the specified message.
  • Example: 
    reactionrole del #roles 123456789012345678
Omex will stop tracking that message and remove the connection between the message and the role.
4

Viewing All Reaction Roles

You can view all currently active role configurations in your server using:
reactionrole list
Example Output:
#roles • 123456789012345678 → @Gamer
#roles • 123456789012345679 → @Artist
5

Permissions & Best Practices

For the system to function properly, Omex and users must have the correct permissions.
User PermissionsBot Permissions
Manage ServerManage Roles
Manage RolesMust be higher than the role it assigns
Omex needs to be above any roles it assigns in your role hierarchy.
You can verify this in Server Settings → Roles.
Best Practices:
  • Use a dedicated channel such as #roles for self-assignable roles.
  • Keep role descriptions clear so users know what they’re selecting.
  • Review your setup using reactionrole list to confirm everything’s linked correctly.
6

Completion

You’ve successfully configured Reaction Roles in your server! 🎉Members can now assign themselves roles through Omex’s built-in interface — no emoji reactions or manual management needed.
For advanced configuration and automation, visit the Reaction Role Module page.