Skip to main content

πŸ‘₯ Reaction Roles

Hello there! Welcome to Reaction Roles guide for Open Ticket. Reaction roles allow you to assign roles to users based on their reactions to a message. This feature was added to the bot after requests from the community, and it’s now an integral part of the bot.

Reaction roles are an interactive way to allow users to assign themselves roles by reacting to a message. Instead of opening tickets, users can select roles in panel buttons.

Reaction Roles

Why not add some roles?


πŸ‘₯ About Reaction Roles​

In Open Ticket, reaction roles are defined using the "role" option type within your options.json configuration file. Instead of creating tickets, when a user reacts to a specific message, they are assigned or removed roles depending on the configuration.

The message you receive when you've added a reaction role.The message you receive when you've added a reaction role.
The message you receive when you've removed a reaction role.The message you receive when you've removed a reaction role.

πŸ”§ Configuration​

You can create reaction roles like any other option in the bot. Take a look at the example provided in the default options.json.

There are many things you can customise, including:

  • roles - Choose which roles you want to add or remove.
  • mode - Choose how the user will interact with the button.
  • remove on add - Provide additional roles to be removed when roles are added.
  • add on join - Automatically add these roles when someone joins the server.

⚠️ Limitations & Recommendations​

While reaction roles provide a great deal of flexibility, keep in mind that:

  • Open Ticket is a Ticket Bot, its only purpose is managing tickets. This feature will ofcourse not be as advanced as in other multi-purpose bots.
  • Reaction roles do not work in dropdown based panels! This might still be added in a future version of Open Ticket.
  • Please do not use reaction roles and tickets in the same panel. It will result in a bad user experience.

πŸ† Summary​

Now you know:
βœ… How reaction roles work in Open Ticket.
βœ… Why they got added to Open Ticket.
βœ… The limitations of reaction roles.

⭐ awesome ⭐

Don't forget to give Open Ticket a star on GitHub to help us grow!

Next Steps​

Learn More​