- Hyperclay
- Docs
- Sharing and teams
- Presence and comments
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.
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 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, 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#
- Open the Comments panel and click New comment.
- 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.)
- 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. - Type your comment (up to 10,000 characters) and click Post comment, or press
Cmd+Enter(Ctrl+Enteron 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, people the document is shared with, 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
@usernamein 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.