# Presence and comments

> See who else has a document open, pin comments to a spot or the whole document, and follow replies and mentions in your inbox.

Source: https://hyperclay.com/docs/presence-and-comments/

When you collaborate on a document in Hyperclay, you can see who else has it open in real time, pin comments to specific elements or to the whole document, and track replies and `@` mentions in your workspace inbox.

## Who else is on the document

When more than one person has the same document open, a row of avatars labelled **In this document now** appears in the document's top bar, to the left of **Share**. The row is hidden when you are the only person on the document.

Up to three avatars are shown directly, followed by `+N` for additional named people and `+N viewing` for anonymous readers. Hovering an avatar shows the person's name, or `Name, can edit` when they hold edit rights. Solid indicators mark people who can edit, and hollow ones mark people who are reading.

**Names are shown only to people who hold view access to the document.** Someone reading a public page with no access of their own sees only a `+N viewing` count and no names. A holder of a [view link](https://hyperclay.com/docs/share-links/) has view access to the document, so they see names, and they appear to everyone else as `Guest 1`, `Guest 2`, and so on.

**The count of anonymous readers counts connections, not people.** One person with three browser tabs open counts as three connections. Opening the **Code** panel does not add an extra reader connection.

**In a block-based document, you see where the others are typing.** Each person editing a document built on the ClayJS page editor, such as the Block editor template, shows on the page as a caret and a highlighted selection labelled with their name. Other documents have no live cursors. Through [ClayJS Live Sync](https://clayjs.com/docs/guide/live-sync/), two people editing different parts of a page merge cleanly, and blocks another person is actively editing are outlined on the page. You also get a one-line notice when somebody else changes the part of the page you were working in; dismiss it or recover your replaced text and carry on.

## Comments

Open the **Comments** panel from the comment icon in the document toolbar or from the document's **Comments** tab. When a document has unread open comments, the toolbar icon displays an unread badge (`Comments, N open, unread`, up to `99+`).

### Who may read and post comments

Anyone signed in to Hyperclay who can view the document can read its comments. Signed-out visitors cannot open comments (`Sign in to use comments.`).

Posting a comment, replying, editing, resolving, reopening, and deleting require a signed-in account with a confirmed email address. Until you confirm your email address, the write controls are hidden and comment actions answer `Confirm your email address to comment.`.

### Pin a comment to a spot or the whole document

1. Open the **Comments** panel and click **New comment**.
2. Choose **Pick a spot** to attach the comment to an element on the page, or **Comment on the whole document**. (If the document does not support element anchors, the composer opens directly for a whole-document comment.)
3. When you choose **Pick a spot**, the panel prompts `Click something in the document. Press Escape to cancel.` Click the part of the page you want to comment on.
4. Type your comment (up to 10,000 characters) and click **Post comment**, or press `Cmd+Enter` (`Ctrl+Enter` on Windows and Linux).

A comment pinned to a spot displays a quote preview (up to 120 characters) of the anchored text. Whole-document comments are labelled **Whole document**.

If the document changes after a spot comment is posted, the thread header tells you what happened to its anchor:

- **Text changed since this comment**
- **Hidden in the document right now**
- **Not found in the document**
- **Matches more than one place**

Click **Choose a new location** on the thread to re-pin it to a current spot on the page.

### Mention someone

Type `@` inside the comment composer to open the **People** list, then pick a person by name and `@username`. The list offers up to 200 people who have read access to the document, drawn from the document owner, [team members](https://hyperclay.com/docs/teams/), people the document is [shared with](https://hyperclay.com/docs/share-with-a-person/), and earlier comment authors on that document.

### Reply, edit, resolve, and delete

Each comment thread in the panel supports the following actions:

- **Reply**: Click **Reply** on a thread, write your response, and click **Reply** to post it.
- **Edit**: Click **Edit** on your comment to update its text. Edited comments are marked `edited`.
- **Delete**: Click **Delete**, then click **Confirm delete** within 4 seconds. Deleted comments display `Comment deleted`.
- **Resolve and reopen**: Click **Resolve** to close an open thread. Resolved threads move out of the open list; click **Show resolved (N)** at the top of the panel to display them, and click **Reopen** on any resolved thread to move it back to open comments.
- **Export**: Click **Download comments (JSON)** in the panel header to download all comments on the document as a JSON file.

If someone else updates or resolves a thread while you are replying or editing, Hyperclay keeps your draft text in the box and alerts you with `Someone changed this thread. Try again.` or `This thread was resolved or deleted by someone else.`.

## Inbox

Click **Inbox** in the workspace sidebar to see comment activity across your documents. The sidebar entry shows a bell icon and an unread badge that updates automatically.

### What lands in the inbox

A notification arrives in your inbox when another person:

- **mentioned you** with `@username` in a comment or reply
- **replied** to a thread you started or previously replied to
- **commented** to start a new thread on a document in your personal workspace
- **resolved a thread** that you started

Your own comments, replies, and resolves never generate notifications for you. Clicking any row in the inbox opens that document's **Comments** panel directly at the thread. Threads that have been closed show a **Resolved** tag.

### Filters and email notifications

Use the filter tabs at the top of the **Inbox** page to switch between:

- **All**: Every notification, 50 per page (click **Load more** for older items).
- **Unread**: Only unread threads (`Nothing unread.` when caught up).
- **Mentions**: Only comments where someone `@` mentioned you (`No mentions.` when empty).

To change which comment notifications also arrive by email, open the account menu at the top right of the workspace and choose **Comment emails…**. You can pick **All comments**, **Mentions only**, or **None**. Resolving a thread never sends an email, and changing your email preference does not change what appears in your in-app **Inbox**.
