# Comments & Mentions {#comments--mentions}


A rich commenting system with @mention support for discussions on tasks, projects, and other entities.


## Overview {#overview}


Gauzy provides a full-featured commenting system that enables:

- Threaded discussions on any entity (tasks, projects, etc.)
- @mention colleagues to notify them
- Rich text formatting
- Comment resolution workflow
- Activity tracking for all comments


## Adding Comments {#adding-comments}


1. Open any task or entity detail view
2. Scroll to the comments section
3. Type your comment in the editor
4. Use `@` to mention team members
5. Click **Submit**


## Threading {#threading}


Comments support parent-child threading:

- Reply to specific comments to create threads
- Threads can be collapsed/expanded
- Each reply notifies the original commenter


## @Mentions {#mentions}


Type `@` followed by a name to mention someone:

- Mentioned users receive a notification
- Mentions link to user profiles
- Mentions are tracked in the Mention entity for auditing


## Comment Resolution {#comment-resolution}


| Status       | Description                     |
| ------------ | ------------------------------- |
| **Open**     | Active discussion               |
| **Resolved** | Discussion resolved by a member |

Comments can be marked as resolved with:

- Resolution timestamp
- ID of the user who resolved


## Actor Types {#actor-types}


| Type     | Description               |
| -------- | ------------------------- |
| `User`   | Comment from a human user |
| `System` | Automated system comment  |


## API Reference {#api-reference}


See [Comment & Mention Endpoints](https://sourcey-gauzy.pages.dev/api/comment-mention-endpoints/index.md) for the complete API documentation.


## Related Pages {#related-pages}


- [Reactions](https://sourcey-gauzy.pages.dev/features/reactions/index.md) — emoji reactions on comments
- [Entity Subscriptions](https://sourcey-gauzy.pages.dev/features/entity-subscriptions/index.md) — subscribe for comment notifications
- [Task Management](https://sourcey-gauzy.pages.dev/features/task-management/index.md) — tasks with comments