# Comments and notifications

Source: https://www.gryz.ai/docs/comments/overview/
Updated: 2026-11-04

## What are comments? [#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 [#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](/docs/publishing/visibility-and-sharing/#share-roles-view-comment-edit) to pick what each person can do.

## Comment on a passage [#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.

1. Select some text.
2. Press **Comment** (on a phone, the button that appears while text is selected).
3. 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:*&#x2A; the check mark at the top right of a comment resolves it. The &#x2A;*…** 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](/docs/comments/html-pages/).

Other document types (SVG, CSV and so on) keep one thread under the document.

## Resolve and reopen [#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 @ [#mention-someone-with-]

Type &#x2A;*@** 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 [#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](/docs/publishing/edit-in-the-page/).

## Notifications [#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 [#let-your-ai-agents-help]

Connect an AI app through [MCP](/docs/mcp/setup/) 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](/docs/comments/agents/) for how it works, how to turn it on, and example prompts.

## Related reading [#related-reading]

* [A document workspace for humans and AI agents](/gryzle/document-workspace-for-humans-and-ai-agents/)
* [How do people and AI agents edit the same document?](/gryzle/people-and-ai-agents-edit-the-same-document/)
