# Collaborative Commenting

Data-level commentary is commonly used in real-life scenarios. PowerTable allows you to add comments to individual cells, rows, and columns in a table to provide context to your data, collaborate with your team by tagging them, and assign tasks. All of these features are available without the need for any coding.

#### Key highlights

* Add comments and annotations to individual cells, rows, and columns.
* Add a dedicated comment column to add row-level comments.
* Tag users and stakeholders using @mention and reply to others' comments.
* Tagged members are notified through an email instantly with the relevant link to take action at a data point level.
* Assign tasks and collaborate with your team, especially for workflow use cases.
* Using the commentary audit log, track tasks and audit the entire list of comments, including details like who wrote them, what they wrote, and when (date and time).
* Comments are always associated with a specific data point, row, or column, so when the data is filtered, the comment appears at the appropriate location.

The comments feature is located at the top of the toolbar, near your user profile.

### **1. Add New Comment**

You can add formatted data-level comments, which are saved securely to the database, along with details such as author and time stamp.

1. Select a cell/column where you want to add a comment. Then click on **Comments.**

<figure><img src="https://1781349671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyXRCFh0c08ryiUFvyMV%2Fuploads%2FvT7jOJ7HJRWFqmUXtVlJ%2Fimage.png?alt=media&#x26;token=3e93ff8e-1c30-44d0-a5e2-b6118afff050" alt=""><figcaption><p>Add comment</p></figcaption></figure>

2. You can also click the **Add New Comment** option from the dropdown to add a new comment.

<figure><img src="https://1781349671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyXRCFh0c08ryiUFvyMV%2Fuploads%2FNxl09yhF7XRzHggJ9V74%2Fimage.png?alt=media&#x26;token=1cd2fae9-e242-48f5-a748-3c71e183290e" alt=""><figcaption><p>Add a new comment</p></figcaption></figure>

3. The comments editor opens up. Enter a comment and click on the highlighted icon.

<figure><img src="https://1781349671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyXRCFh0c08ryiUFvyMV%2Fuploads%2FkMgVuMJ74a6NAeQHOPJT%2Fimage.png?alt=media&#x26;token=0caf44eb-7e94-4726-8989-b0269a26e719" alt=""><figcaption><p>Post the comment</p></figcaption></figure>

4. The comment gets posted. You can see a green indicator on the top right corner of the cell. Hovering over it reveals the comment that has been added.

<figure><img src="https://1781349671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyXRCFh0c08ryiUFvyMV%2Fuploads%2FTFkzGXUNk1CIxO0dE4Oe%2Fimage.png?alt=media&#x26;token=c5356cd4-f941-42f2-8777-d352833c96f5" alt=""><figcaption><p>Comment posted</p></figcaption></figure>

### **2. Edit a Comment**

To edit a comment, hover over the cell containing the comment and click on the pencil icon. You can then start editing the comment.

<figure><img src="https://1781349671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyXRCFh0c08ryiUFvyMV%2Fuploads%2FKctPD8H4a2KqO3IUrn4X%2Fimage.png?alt=media&#x26;token=5c66c0cd-8a4e-4163-bd08-9715c7c8218d" alt=""><figcaption><p>Edit comment</p></figcaption></figure>

### 3. Delete a Comment

To delete a comment thread, click on the bin icon.

<figure><img src="https://1781349671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKyXRCFh0c08ryiUFvyMV%2Fuploads%2FxsjfzRrV2veOKfL2Smo0%2Fimage.png?alt=media&#x26;token=36bf049a-8334-403a-810f-faa04328eea6" alt=""><figcaption><p>Delete comment</p></figcaption></figure>

### **4.** Mention other users

You can use the @ symbol to tag other stakeholders and draw their attention​.

1. Click on a cell and then choose **Add a comment**. Type @ in the comment editor. You will see a list of the users in the workspace.
2. Select the desired user, add the comment, and click **Post.**
3. The comment gets posted successfully.

### 5. Reply to a Comment

To reply to a comment, simply click on the comment and choose **Reply**. The comment reply gets added as a thread, and the number of replies is shown along with the comment.

### **6. Comments Column**

You can add a dedicated comments column to capture row-level comments.

1. In the 'Comments' dropdown, turn the **Comments column** toggle on. The comments column gets added.
2. Click on any cell in the comments column. The comment editor opens. Enter a comment and click **Post**.
3. The comment gets added as shown in the below image.
4. To reply to a comment in the comments column, simply click on the comment and then select **Reply.**
5. The number of replies is also shown along with the comment.
6. To hide the comments column, turn off the toggle.

### **7. Hide All Comments**

To hide comments temporarily, turn on the **Hide All Comments** toggle.

### 8. Email Notifications

The ‘@user’ mention in the comment automatically sends an email notification to the user with a link to the report so that the user can respond to this comment and update the data if required. Replies to the comments are also notified to the user instantly.

1. Email notifications on comment replies can be turned off. In the dropdown highlighted, click on **Profile Settings**. In the side panel, turn off the toggle.
2. Email notifications for new replies or mentions can be turned off. In the **Settings** panel, uncheck the highlighted checkbox.

[This section](https://docs.powertable.com/explore-powertable/collaborative-commenting/comment-settings) covers all of the other options in the comments settings panel in detail.

In the next section, we'll see how you can assign & track tasks.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fabricplan.com/powertable-sheets/how-tos/collaborative-commenting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
