> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autype.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Comments Panel

> Add inline comments to your document, reply to threads, and collaborate with your team.

The **Comments** panel (<Icon icon="message-circle" size={16} />) lets you add inline comments to specific lines in your document. Comments are anchored to the content and stay in sync as you edit. Use them to leave feedback, ask questions, or coordinate with collaborators.

<Frame>
  <img src="https://mintcdn.com/centerbit/TtPv7-oz376rL_ZT/images/application/sidebar-comments/sidebar-comment-panel.png?fit=max&auto=format&n=TtPv7-oz376rL_ZT&q=85&s=68e3d32d07a557985f5b11b6e4e1194a" alt="Comments sidebar panel" width="1495" height="979" data-path="images/application/sidebar-comments/sidebar-comment-panel.png" />
</Frame>

***

## Creating a comment

To add a comment, hover over the area between the line number and the text in the editor. A <Icon icon="plus" size={16} /> button appears on the current line.

<Frame>
  <img src="https://mintcdn.com/centerbit/TtPv7-oz376rL_ZT/images/application/sidebar-comments/add-comment-button-in-editor.png?fit=max&auto=format&n=TtPv7-oz376rL_ZT&q=85&s=7899299217f8819eed9e15cbbc54cf9a" alt="Plus button appearing in the editor gutter on hover" width="403" height="160" data-path="images/application/sidebar-comments/add-comment-button-in-editor.png" />
</Frame>

Click the button to open the **Add Comment** modal. The modal shows the target line number and a text field for your comment. Press **⌘ + Enter** (or **Ctrl + Enter**) to submit, or click **Add Comment**.

<Frame>
  <img src="https://mintcdn.com/centerbit/TtPv7-oz376rL_ZT/images/application/sidebar-comments/add-comment-modal.png?fit=max&auto=format&n=TtPv7-oz376rL_ZT&q=85&s=fba7fde0ff2c1ff11ce8d950ef2650e1" alt="Add Comment modal with line number and text input" width="610" height="370" data-path="images/application/sidebar-comments/add-comment-modal.png" />
</Frame>

The comment is now anchored to that line and appears in the sidebar.

***

## Comment anchor placement

Comment anchors are invisible markers embedded directly in your Markdown source. Where exactly the anchor is placed depends on the type of content you comment on:

* **Single-line elements** (headings, paragraphs, list items, etc.) — the anchor is inserted on the same line, at the end of the text.
* **Multi-line elements** (code blocks, tables, lists, blockquotes, etc.) — the anchor is placed on a **new line directly below** the element. Commenting on any item within a list or any row within a table will place the anchor after the entire block. This is because inserting a marker inside a multi-line block would break its syntax.

### Anchor movement during editing

Because anchors live inside the document text, they behave like any other character when you edit around them:

* **Pressing Backspace** at the beginning of the line below the comment icon will delete the anchor. This happens because the anchor marker is stored at the end of that line — pressing Backspace merges the lines and removes the anchor in the process.
* **Deleting lines** above the anchor shifts it upward.
* **Adding lines** above the anchor shifts it downward.

This means the comment may appear to "move" to a different line after edits — it is still attached to the same position in the text, but the line number changes as surrounding content shifts.

<Note>
  If the anchor ends up in an unexpected position after editing, you can always click the comment in the sidebar to jump to its current location in the editor.
</Note>

***

## Viewing comments

The sidebar lists all comment threads for the current document. Each card shows the author's avatar, name, timestamp, and the comment text.

<Frame>
  <img src="https://mintcdn.com/centerbit/TtPv7-oz376rL_ZT/images/application/sidebar-comments/sidebar-comments-list-2examples.png?fit=max&auto=format&n=TtPv7-oz376rL_ZT&q=85&s=afc835fd2cb8e3772334078f528653fe" alt="Comments list showing two example comments" width="350" height="529" data-path="images/application/sidebar-comments/sidebar-comments-list-2examples.png" />
</Frame>

Only the comments of the **selected** (expanded) thread are fully visible. Collapsed threads show a reply count if they have replies — click a thread to expand it.

### Filter tabs

When comments exist, three filter tabs appear at the top:

| Tab          | Shows                   |
| ------------ | ----------------------- |
| **All**      | All comment threads     |
| **Open**     | Unresolved threads only |
| **Resolved** | Resolved threads only   |

***

## Navigating between editor and comments

Comments and the editor are linked **bidirectionally**:

* **Sidebar → Editor**: Click a comment thread in the sidebar to jump to the corresponding line in the editor. The editor scrolls to and highlights that line.
* **Editor → Sidebar**: Lines with comments show an amber <Icon icon="message-circle" size={16} /> icon in the gutter. Click it to open the Comments panel and select that thread.

<Frame>
  <img src="https://mintcdn.com/centerbit/TtPv7-oz376rL_ZT/images/application/sidebar-comments/goto-comment-buttons-in-editor.png?fit=max&auto=format&n=TtPv7-oz376rL_ZT&q=85&s=66d0d8115dd56770d84029000ac9fba0" alt="Comment bubble icons in the editor gutter for navigating to comments" width="325" height="240" data-path="images/application/sidebar-comments/goto-comment-buttons-in-editor.png" />
</Frame>

***

## Thread actions

Hover over a comment thread and click the <Icon icon="ellipsis" size={16} /> menu to access actions:

<Frame>
  <img src="https://mintcdn.com/centerbit/TtPv7-oz376rL_ZT/images/application/sidebar-comments/comment-menu-resolve-delete.png?fit=max&auto=format&n=TtPv7-oz376rL_ZT&q=85&s=b8ab306a1a99a7c4a5eeefde019d71e8" alt="Comment dropdown menu with Resolve and Delete options" width="287" height="177" data-path="images/application/sidebar-comments/comment-menu-resolve-delete.png" />
</Frame>

* **Resolve** — marks the thread as resolved. Resolved threads appear grayed out and move to the **Resolved** filter tab. You can reopen a resolved thread from the same menu.
* **Delete** — permanently removes the thread (only available for your own comments).

### Replies

When a thread is expanded (selected), a reply input appears at the bottom. Type your reply and press **Enter** to send. You can also use quick emoji reactions (👍 ❤️ 🎉 👀) via the <Icon icon="thumbs-up" size={16} /> button when the input is empty.

***

## Orphan comments

Comment anchors are embedded in your document as hidden markers. If you delete the line that contains an anchor, the comment loses its position in the document.

<Note>
  When a comment anchor is removed (e.g., by deleting the line), the comment is **not** automatically deleted. It remains in the sidebar but is grayed out with an amber "Removed from document" warning. You can still read it, but replying is disabled. To fully remove it, delete the thread manually via the <Icon icon="ellipsis" size={16} /> menu.
</Note>
