> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sublay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> The 8-type reaction system for entities and comments

Sublay supports 8 distinct reaction types on both entities and comments. Each reaction type has a defined impact on the author's reputation score.

> [!NOTE]
>
> **Requires the `reactions` bundle.** Reactions are only available when the `reactions` bundle is installed on your project. See [Bundles](https://docs.sublay.io/v7/bundles.md) to add it.

## Reaction Types

| Type | Reputation Impact |
| - | :-: |
| `upvote` | +1 |
| `downvote` | -1 |
| `like` | +1 |
| `love` | +2 |
| `wow` | +1 |
| `sad` | 0 |
| `angry` | 0 |
| `funny` | +1 |

Each entity and comment stores a `reactionCounts` object with a count for each type, and a `userReaction` field with the authenticated user's current reaction (or `null`).

## The Toggle Pattern

The recommended way to work with reactions is `useReactionToggle`. It manages optimistic updates, handles toggling (selecting the same reaction again removes it), and reverts state on server errors.

```tsx theme={null}
import { useReactionToggle } from "@sublay/react-js";

function ReactionButton({ entity }) {
  const { currentReaction, reactionCounts, toggleReaction, loading } = useReactionToggle({
    targetType: "entity",
    targetId: entity.id,
    initialReaction: entity.userReaction,
    initialReactionCounts: entity.reactionCounts,
  });

  return (
    <button
      onClick={() => toggleReaction({ reactionType: "upvote" })}
      disabled={loading}
    >
      {reactionCounts.upvote ?? 0} Upvotes
      {currentReaction === "upvote" ? " (active)" : ""}
    </button>
  );
}
```

## Hooks

> [card] [useReactionToggle](https://docs.sublay.io/v7/hooks/reactions/use-reaction-toggle.md)
>
> Manage reaction state with optimistic updates and toggle behavior. The recommended hook for reaction UIs.

> [card] [useAddReaction](https://docs.sublay.io/v7/hooks/reactions/use-add-reaction.md)
>
> Low-level hook to add a reaction to an entity or comment.

> [card] [useRemoveReaction](https://docs.sublay.io/v7/hooks/reactions/use-remove-reaction.md)
>
> Low-level hook to remove the authenticated user's reaction.

> [card] [useFetchEntityReactions](https://docs.sublay.io/v7/hooks/reactions/use-fetch-entity-reactions.md)
>
> Fetch a paginated list of reactions on an entity, optionally filtered by type.

> [card] [useFetchCommentReactions](https://docs.sublay.io/v7/hooks/reactions/use-fetch-comment-reactions.md)
>
> Fetch a paginated list of reactions on a comment, optionally filtered by type.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.