> ## Documentation Index
> Fetch the complete documentation index at: https://replyke-feat-push-rich-payload-fields.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Use replies

> Fetch and paginate replies for a specific comment

## Overview

`useReplies` loads replies for a specific comment from the `entityCommentsTree` managed by the nearest `CommentSectionProvider`. It fetches a page of replies when the `page` state increases above `0`.

<Note>
  Must be used inside a `CommentSectionProvider`. Replies are merged into the shared `entityCommentsTree`.
</Note>

## Usage Example

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

function CommentItem({ commentId }: { commentId: string }) {
  const { replies, newReplies, loading, setPage } = useReplies({
    commentId,
    sortBy: "createdAt",
  });

  return (
    <div>
      <button onClick={() => setPage((p) => p + 1)}>Load replies</button>
      {[...newReplies, ...replies].map((r) => (
        <div key={r.id}>{r.content}</div>
      ))}
    </div>
  );
}
```

## Props

<ParamField path="commentId" type="string" required>
  The ID of the comment to load replies for.
</ParamField>

<ParamField path="sortBy" type="CommentsSortByOptions" required>
  Sort order for replies: `"createdAt"` or `"top"`. `"new"`/`"old"` are deprecated aliases for `"createdAt"` (removed in v8).
</ParamField>

<ParamField path="sortDir" type="&#x22;asc&#x22; | &#x22;desc&#x22;">
  Sort direction for `sortBy: "createdAt"`. Default: `"desc"` (newest first).
</ParamField>

## Return Values

<ResponseField name="replies" type="(Comment & { new: boolean })[]">
  Paginated replies (not newly submitted in this session).
</ResponseField>

<ResponseField name="newReplies" type="(Comment & { new: boolean })[]">
  Replies submitted in this session, sorted newest-first.
</ResponseField>

<ResponseField name="loading" type="boolean">
  `true` while replies are being fetched.
</ResponseField>

<ResponseField name="page" type="number">
  Current page number. Starts at `0` (no replies loaded). Increment to load replies.
</ResponseField>

<ResponseField name="setPage" type="Dispatch<SetStateAction<number>>">
  Increment to trigger loading the next page of replies.
</ResponseField>