Comments and notifications
Comment on a passage or a whole document, resolve threads, mention people with @, and get notified about hearts, comments, replies and mentions.
Jacob Cansler · Maker of Gryz
Updated Reviewed by Jacob Cansler
What are comments?
Comments let people talk about a document right on its page. They work two ways, with the same tools:
- Public documents: signed-in people can comment, next to the hearts.
- Private documents: you and the people you shared the document with can leave review comments for each other. Nobody else can see or add them.
Comments are free with any Gryz account. They are not a paid feature.
Who can comment
| Document | Who can read the comments | Who can comment |
|---|---|---|
| Public | Anyone who can open the document, signed in or not | Any signed-in account |
| PIN-protected | Anyone who unlocked it with its PIN | Signed-in accounts that unlocked it |
| Private (restricted) | The owner and everyone it is shared with | The owner and people shared as Comment or Edit. People shared as View read only. |
There are no anonymous comments, and company documents don't have comments yet. See share roles to pick what each person can do.
Comment on a passage
On a Markdown document or an HTML page you can comment on the exact words you mean, not just the whole page.
- Select some text.
- Press Comment (on a phone, the button that appears while text is selected).
- Write your comment and post it.
Where the comments show:
- On a computer, threads sit in a panel beside the document, in page order. Each one starts closed: click it to read the replies and highlight its passage. Comment at the top of the page shows and hides the panel, with the number of open comments. With the panel hidden, small icons stay next to each commented passage.
- On a phone, comments open in a sheet, one thread at a time. Use the next and previous arrows to move between them.
- Filter: the panel shows Open comments. The menu beside the title switches to Resolved or Outdated, and General goes to the comments under the page. A comment becomes outdated when its passage is deleted or rewritten so much that Gryz can no longer find it. The words the person selected stay with the comment.
- Small edits: a comment stays on its passage as the words around it change, and it still shows the words the person first selected.
- Re-attach: if you can resolve an outdated comment, you can put it back on the right text, wherever text can be selected for comments. Open it, select the new text in the document, and press Re-attach. On a phone, press Re-attach first, select the text, then press Attach here.
- Resolve and more: the check mark at the top right of a comment resolves it. The … menu holds Edit, Delete, Report and the comment's agent settings.
- Reactions: where they are on for your account, you can answer a comment with one tap. Tap an emoji to set it, another to change it, or the same one to take it back. You get one reaction per comment. Everyone sees the emoji and counts, not who reacted. The person whose comment you reacted to gets a notification with your name. Agents can read the counts, but a reaction is never approval.
HTML pages work the same way, with a few extras for pages that run scripts. See Comments on HTML pages.
Other document types (SVG, CSV and so on) keep one thread under the document.
Resolve and reopen
When a comment is handled, press the check mark and it moves to Resolved. Press Reopen to bring it back.
- The owner and people shared as Edit can resolve any thread.
- Anyone who can comment can resolve a thread they started.
- Accepting a suggested change that answers a comment resolves it for you.
Mention someone with @
Type @ in a new comment, a reply or the general thread and pick a name.
- Who you can mention: on a private document, the owner and the people it is shared with. On a public document, the owner and people who already commented there (the owner also sees the people they shared it with).
- Names only. The list never shows email addresses, and it never searches all Gryz accounts.
- Up to 5 people per comment. Each one gets a "mentioned you" notification.
- If someone loses access to the document, their mention notification goes away.
How comments work
- Plain text, up to 2,000 characters. No formatting and no HTML. Links go through the same safety check as other content on Gryz.
- One level of replies. Reply to a comment and the reply sits under it. Replies to replies stay in the same thread.
- Edit for 15 minutes. After that a comment is final, but you can still delete it.
- Delete any time. Your own comments, always. As a document's owner you can also delete any comment on your document.
- Turn comments off. In a document's settings you can switch comments off. The thread is hidden and nobody can add to it. Comments are on by default.
- Report a comment. Anyone signed in can report a comment. After three reports it is hidden from view while a moderator looks at it.
- Comments stay visible while you edit. See Edit in the page.
Notifications
When something happens on your documents, a bell tells you:
- on a computer, the bell sits next to your name at the top right
- on a phone, it is the Alerts tab in the bottom bar
A number on the bell shows how many things are new. You get notified when:
- someone hearts your document (several hearts on one document are grouped into one line)
- someone comments on your document
- someone replies to your comment
- someone mentions you with @
- someone reacts to your comment, where reactions are on for your account
- someone comments on a private document shared with you, after you have already commented on it
You are never notified about your own actions. Notifications stay in the app (no email yet) and are cleared after 90 days.
Let your AI agents help
Connect an AI app through MCP and it can go through comments with you. It brings each comment to you and asks what to do before it acts, and any change it makes waits for a person to accept it in Gryz. You can also set a rule on each comment: Agents can help, Human review required or No agent edits.
Read Comments and AI agents for how it works, how to turn it on, and example prompts.
Related reading
Next steps
- Comments on HTML pagesSelect words on an HTML page in Gryz and comment on exactly that passage, with highlights, a phone sheet, and a live view for pages with scripts.
- MCP setup (Claude, ChatGPT, Cursor, Windsurf, Codex)Step-by-step MCP connection for Claude.ai, ChatGPT, Cursor, Windsurf, and Codex with OAuth or API key authentication.
Company tasks
Give a piece of work to a colleague or a company agent, say when it is due, link the documents it is about, and name who must review it.
Comments and AI agents
Let Claude, ChatGPT, Cursor or another MCP app go through comments with you: it asks before it acts, and its changes wait for a person to accept them.