> For the complete documentation index, see [llms.txt](https://docs.papers.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.papers.ai/collaborating/comments.md).

# Comments

Comments let you and your collaborators discuss specific content without changing it.

## Add and manage comments

{% stepper %}
{% step %}

### Start a thread

Select the text or board item you want to discuss, and start a thread from the **Comments** panel in the right sidebar.
{% endstep %}

{% step %}

### Post it

Write your comment and post it.
{% endstep %}

{% step %}

### Reply

Reply to continue a discussion, using `@mentions` where useful.
{% endstep %}

{% step %}

### Share or resolve

Use **Share Link** to send someone a direct link to a specific thread. Mark the thread **Resolved** when you're done, or reopen it if the conversation continues.
{% endstep %}
{% endstepper %}

Comments appear both in the **Comments** panel and as floating cards anchored to the relevant content in the editor. There isn't an inline, Word-style comment mode yet.

## Things to know

* In a private, unshared project, comments are local to your session only. Nobody else sees them. Sharing the project turns on real cross-user delivery.
* Viewers can create and reply to comments; resolving a thread needs to be the author or an editor; deleting a thread needs admin access.
* Comment bodies are capped at 5,000 characters, quotes at 500 characters, and mentions at 20 per comment.

## Troubleshooting

<details>

<summary>You can't add or update a comment</summary>

Check your connection and role, then retry.

</details>

<details>

<summary>A thread link doesn't jump to the right place</summary>

The content it was anchored to may have been edited or removed.

</details>

<details>

<summary>@mentions don't suggest anyone</summary>

Confirm the project has other members. Mentions only work for people with access.

</details>

## Next steps

* [Real-time collaboration](/collaborating/real-time-collaboration.md)
* [Share a project and manage access](/collaborating/share-a-project-and-manage-access.md)