# Discourse Reactions

**URL:** https://meta.discourse.org/t/discourse-reactions/183261
**Category:** Plugin
**Tags:** official, reactions, included-in-core
**Created:** [March 15, 2021, 4:47am UTC](https://meta.discourse.org/t/discourse-reactions/183261 "2021-03-15T04:47:30Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [March 15, 2021, 4:47am UTC](https://meta.discourse.org/t/discourse-reactions/183261/1 "2021-03-15T04:47:30Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Discourse Reactions** allows users to React to a post from a choice of emojis, rather than only the Like heart. The available emoji selection can be set from the admin settings. |
| 📖 | **Install Guide** | **This plugin is bundled with Discourse core**. There is no need to install the plugin separately. |

> [@](#):
>
> :discourse2: As this is an #official plugin maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started. 👍
> 
> [❓ **Support**](https://meta.discourse.org/new-topic?category_id=6&body=%3E%20Before%20asking,%20did%20you%20search%20first%3F%20Press%20%F0%9F%94%8D%20at%20the%20upper%20right%20to%20search.&tags=reactions "Ask for support on configuring and using Discourse Reactions") [🐛 **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=reactions "A bug report means something is broken, preventing normal/typical use of the plugin") [👀 **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=reactions "Discussion about the user interface of Discourse Reactions, and how features are presented (including language and UI elements)") [💡 **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=reactions "Discussion about how existing Discourse Reactions features can be improved or enhanced, and how proposed new features could work")

Bored of likes in Discourse? Here’s something you will definitely love.

**Note: Discourse Reactions will soon be enabled by default for all sites, see** [Enabling Discourse Reactions by default for all sites](https://meta.discourse.org/t/enabling-discourse-reactions-by-default-for-all-sites/403795)

## Overview

Discourse-reactions is a plugin that allows user to add their reactions to the post. This plugin can engage more audiences to the post. Users who may not have previously wanted to Like your content are now able to send more specific signals about how your content makes them feel. Users who may not have wanted to use their phones to post can now use them to “react” much easier.

Reactions can be different on each website as we have an amazing feature where site admin can set their list of emojis which can be used as reactions.

To customize the reactions use the site setting `discourse_reactions_enabled_reactions` and define emojis you want as reactions separated by `|` eg: `open_mouth|cry|angry`

This plugin will work as an add-on to the likes feature, anytime you want to remove the plugin, all likes will be preserved.

  

### Configure

You can configure these Site Settings:

- `discourse_reactions_enabled` To enable the plugin
- `discourse_reactions_enabled_reactions` To define the list of enabled reactions, any emoji is allowed here. `default: laughing|open_mouth|cry|angry|thumbsup|thumbsdown`
- `discourse_reactions_like_icon` To replace the like icon.
- `discourse_reactions_reaction_for_like` To define the name of like reaction.

### Creating a reaction

The reaction can be created either by clicking the like icon OR by hovering and selecting reaction from the reaction picker.

_Note:_

- In Mobile to open the reaction-panel long press on like icon.

 ![Screenshot 2021-03-15 at 10.14.04 AM](https://global.discourse-cdn.com/meta/original/3X/2/7/276fbfe8d51f613ddef486b3801fcccef69e17b5.png)

### See who reacted?

On the left side of the post, there will be a list of reactions, by clicking on it, there will be a modal displayed with the list of reactions.

 ![Screenshot 2021-03-11 at 3.02.16 AM](https://global.discourse-cdn.com/meta/original/3X/3/a/3a41639fd4ef19b66a7dffa9b318bdaccce1e4cf.png)  
If there are only likes in the post, a list of reactions will not be available but there will be a like-count besides the like button. Clicking on it will display the same modal.

 ![Screenshot 2021-03-08 at 1.09.45 PM](https://global.discourse-cdn.com/meta/original/3X/9/1/91a7ff6e14dadb084d40e3b4f55f49b32393326d.png)

Don’t want to see this whole modal? Just hover on the reaction-emoji in the list to see the recently reacted users (Available Only on the desktop site).

### See Your Reactions?

In the user page activity, there is an extra `Reactions` tab where you will find all reactions you made.

 ![Screenshot 2021-03-11 at 3.25.40 AM](https://global.discourse-cdn.com/meta/original/3X/6/2/626091f44ba74865f92778f3d6952573e8370037.png)

### See who reacted to your post?

In the user page notifications, there is an extra `Reactions` tab where you will find all reactions made to your posts.

 ![Screenshot 2021-03-11 at 2.46.52 AM](https://global.discourse-cdn.com/meta/original/3X/9/6/969278313d811e89f91912a8bf8cd6cf346c2f44.png)

### Badge

**First Reaction** Badge is granted to the user when they make their first reaction to a post.

 ![Screenshot 2021-03-15 at 12.50.03 PM](https://global.discourse-cdn.com/meta/original/3X/2/e/2e9c3c2232ca457e3d88c4f9d64c9b305eb96afc.png)

### Contributors

@Ahmed_Gagan

@j.jaffeux  
@kris.kotlarek  
@Roman

### Special Thanks

Special thanks to @j.jaffeux for being such a nice mentor and for being super helpful in everything 👐 and [@team](https://meta.discourse.org/groups/team) for helping us to make the plugin work perfectly by finding as many bugs as possible.

> Last edited by @martin 2026-06-29T23:27:25Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/discourse-reactions/183261)._
