Reactions

Stream Chat supports message reactions such as likes, hearts, and custom reaction types. Users can react to messages, and reactions can include custom data and scores for cumulative reactions.

Sending a Reaction

Add a reaction to a message using the sendReaction method. Each user can have one reaction of each type per message.

// Send a reaction with default score of 1
await message.SendReactionAsync("like");

// Send a reaction with custom score
await message.SendReactionAsync("clap", 10);

// Replace all previous reactions from this user
await message.SendReactionAsync("love", enforceUnique: true);

Reaction Parameters

Name	Type	Description	Default	Optional
message_id	string	ID of the message to react to
type	string	Reaction type. Each user can have one reaction of each type per message.
score	integer	Score for cumulative reactions	1	✓
user_id	string	User ID (required for server-side calls)		✓
enforce_unique	boolean	If true, replaces all existing reactions from this user with the new one	false	✓
skip_push	boolean	If true, do not send a push notification	false	✓
emoji_code	string	Unicode emoji for push notification display		✓
custom data	object	Custom fields for the reaction		✓

Warning:

Custom data for reactions is limited to 1KB.

Removing a Reaction

Remove a reaction by specifying the message ID and reaction type.

await message.DeleteReactionAsync("like");

Field	Type	Description
reaction_counts	object	Count of reactions per type. Example: `{"love": 3, "fire": 2}`
reaction_scores	object	Sum of scores per type. Equals counts for standard reactions; differs for cumulative reactions.
reaction_groups	object	Detailed statistics per type including count, sum_scores, first_reaction_at, last_reaction_at
latest_reactions	array	The 10 most recent reactions with type, user_id, and created_at
own_reactions	array	The current user's reactions on this message

Use reaction_groups instead of reaction_counts for if you're building a custom implementation. The reaction_groups field provides additional metadata including timestamps and is the recommended approach.

To retrieve more than 10 reactions, use pagination.

Paginating Reactions

Retrieve reactions with pagination using limit and offset parameters.

Parameter	Maximum Value
limit	300
offset	1000

// Paginating reactions via API is not yet available in the Unity SDK.
// Please let us know if you'd like this feature implemented: https://github.com/GetStream/stream-chat-unity/issues
// Each message exposes a snapshot of the reaction summary instead:

// The 10 most recent reactions on the message
foreach (var reaction in message.LatestReactions)
{
    Debug.Log($"{reaction.Type} from {reaction.User?.Id}");
}

// The 10 most recent reactions left by the local user
foreach (var reaction in message.OwnReactions)
{
    Debug.Log($"My reaction: {reaction.Type}");
}

// Number of reactions per type, e.g. {"love": 3, "fire": 2}
foreach (var entry in message.ReactionCounts)
{
    Debug.Log($"{entry.Key}: {entry.Value} reactions");
}

// Sum of reaction scores per type (matches counts unless cumulative reactions are used)
foreach (var entry in message.ReactionScores)
{
    Debug.Log($"{entry.Key}: total score {entry.Value}");
}

Querying Reactions

Filter reactions by type or user on a specific message. This endpoint requires the user to have read permission on the channel when called client-side.

// This feature is not yet available in the Unity SDK.
// Please let us know if you'd like this feature implemented: https://github.com/GetStream/stream-chat-unity/issues

Cumulative Reactions

Cumulative reactions allow users to react multiple times to the same message, with the total score tracked. This is useful for features like Medium's "clap" functionality.

Set a score value when sending the reaction. The API returns:

sum_scores: Total score across all users
Individual user scores

await message.SendReactionAsync("clap", score: 5);