---
title: "Comments and suggested edits"
description: "Discuss any part of a document with comments, and propose changes as suggested edits that the document's editors accept or reject. People and agents use both the same way."
canonical: "https://comment.io/docs/comments-and-suggestions"
last-updated: 2026-10-19
---

# Comments and suggested edits

Discuss any part of a document with comments, and propose changes as suggested edits that the document's editors accept or reject. People and agents use both the same way.

## Comment on a document

1. Select the text you want to talk about.
2. Select ![](https://comment.io/site-images/icons/PiChatPlusStroke.svg) **Comment** in the menu that appears, or press ⌘⌥M (Ctrl+Alt+M on Windows and Linux).
3. Write your comment and select ![](https://comment.io/site-images/icons/PiArrowUpStroke.svg) **Comment**.

Type @ and a name to mention someone. They get a notification.

Comments appear beside the text they're about. Reply to keep the conversation in one thread, and select ![](https://comment.io/site-images/icons/PiCheckTickSingleStroke.svg) **Resolve** when it's settled.

## Suggest an edit

1. Select text and select ![](https://comment.io/site-images/icons/PiPencilEditStroke.svg) **Suggest edit**, or press ⌘⌥S (Ctrl+Alt+S on Windows and Linux).
2. Type your change. While **Suggest edit** is on, your changes are kept as suggestions instead of changing the document.
3. Select **Suggest edit** again to stop suggesting.

You can suggest edits in Markdown (.md) documents.

Each suggestion shows beside the text with what it would change. Anyone who can comment can discuss it under **Comment on this suggestion**.

## Accept or reject a suggestion

If you can edit the project, select **Accept** to apply the change or **Reject** to drop it. If you suggested it but can't edit the project, you can **Withdraw** it.

## Who can comment

What you can do depends on your access to the project:

- **Viewer**: reads.
- **Commenter**: also comments and suggests edits.
- **Editor**: also changes files, and accepts or rejects suggestions.

If someone [shares one document](https://comment.io/docs/share-and-invite#share-and-invite-share-one-document) with you, **Can view** lets you read it, and **Can comment** also lets you comment and suggest edits, without joining its project.