> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.sigmacomputing.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server.

# Use comments in workbooks and data models

> Add comments to Sigma workbooks and data models on elements or documents to share context and request feedback.

You can add comments to workbooks and data models, including individual elements, to provide context for charts or control elements, solicit feedback from colleagues, or make requests. When you comment on a workbook or data model, Sigma sends an email to all editors of the document who have previously published a version.

When you add comments, make sure that your workbook is published or saved. If you want to add comments to an exploration, you must first save the exploration as a new workbook. If you add comments to a custom view of a workbook, merge your changes into the workbook or save your custom view before commenting.

## User requirements

* To view and add comments in workbooks, you must be assigned an [account type](/docs/create-and-manage-account-types) with the **Can comment on workbooks** permission enabled.
* To view and add comments on a data model, you must be assigned an [account type](/docs/create-and-manage-account-types) with the **Can comment on workbooks** permission enabled and be granted **Can edit** access to the data model.

> **Info**
>
> If you want to annotate a captured screenshot of an element in a comment, you must have at least **Can explore** access to the document. See [Capture and annotate images in comments](/docs/annotate-element-images-as-comments).

## View comments

To see comments on a workbook or data model, click the document name, then in the document menu, select **Comments**.

A panel opens and displays all comment threads.

![The Comments panel open on a published workbook, scoped to All elements, with a comment from Sigma Docs posted 22 minutes ago and a Reply link beneath it.](/_fern-img/74e4996419df47dcf09b2008335eaf98a75f50f23654df2cb039a11fd451a828.webp)

### Close the comments panel

To close the **Comments** panel, click ![](https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/close2.svg) **Close comments panel** in the top right corner of the panel.

## Add a new comment

To add a new comment to a workbook or data model:

1. In the document header, click the document name, then in the document menu, select **Comments**.
2. Type your comment in the text box. You can @-mention other Sigma users in your comment to notify them of your comment.
3. Click **Comment** or press the keyboard shortcut (⌘ + enter on Mac, ctrl + enter on Windows).

   ![The Comments panel on the Example Data Model overview page, with a draft comment that mentions @test@example.com and the Comment button enabled.](/_fern-img/968254f1039362332f4fd386168faef8b53b6af26e160e239c4db86701e5af3d.webp)

> **Tip**
>
> You can also add images to comments. See [Capture and annotate images in comments](/docs/annotate-element-images-as-comments).

## Comment on an individual element

To add a comment to a specific element:

1. Hover over the element.
2. Click the element menu at the element's top right corner.
3. Select **Comment**.

   The **Comments** panel opens with the specific element selected.

   ![The Comments panel scoped to the Organic Traffic by Country element, which is also outlined as selected on the workbook page, with a draft comment that mentions @test@example.com.](/_fern-img/48bc6ff1d8390b1e8b9327c2f130639e0d0465ba8f879e682ae23b38a1fd2978.webp)
4. Enter your comment.
5. Click **Comment**.

## Mention a user in a comment

The mentioned users receive an email notification about your comment.

1. When you add a comment, type @ to review and select from a list of users you can mention in your comment.
2. Start searching for a user by typing their name or email.
3. Scroll or use the arrow keys to locate who you want to mention, then click or press Enter or Tab to select the user.
4. After you save your comment, the user receives an email notification.
5. If a mentioned user does not have permissions to view the workbook, a gray box appears under the comment prompting you to grant those permissions. To grant the user view access, click **Grant view access**. If you do not grant the user permission to view the workbook, they do not receive an email notification.

## Reply to a comment

To reply to a specific comment and start a comment thread:

1. In the **Comments** panel, scroll to the comment you want to reply to.
2. In the bottom left corner of the comment, click **Reply**.

   A text box opens.
3. Add your response.
4. Click **Reply** to add your reply.

## Manage comments

You can edit, delete, and resolve comments on a workbook or data model.

### Edit a comment

You can only edit your own comments. To modify a comment that you made:

1. In the **Comments** panel, locate the comment you want to edit, then click ![](https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/more.svg) **More**.
2. Select **Edit**.
3. Update the comment.
4. Click **Save changes**.

### Delete a comment

You can delete your own comments. If you're assigned the Admin account type, you can delete any comment.

1. In the **Comments** panel, select ![](https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/more.svg) **More** for the comment that you want to delete.
2. Select **Delete**.

If the deleted comment had replies, the replies are still visible. If it had no replies, Sigma removes the thread.

### Resolve a comment thread

When you resolve a comment, the comment and any replies are hidden from the **Comments** panel unless the option to **Show resolved** is turned on.

To resolve a comment thread:

1. Hover over the first comment in the comment thread that you want to resolve.
2. Select the checkbox ![](https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/check-circle_outline.svg) (**Resolve thread**).

   The entire comment thread is resolved, including replies to the resolved comment.

### Reopen a comment thread

To reopen a previously resolved comment thread:

1. From the **Comments** panel, turn on the option to **Show resolved**.
2. Scroll to the comment thread you want to reopen.
3. Click **Re-open thread**, or add a reply by clicking **Reply** at the bottom of the thread.

   The comment thread is reopened.

## Find your comment notifications

All users who have published a version of the document receive email notifications for any comments added to the workbook or data model. In addition, when you are mentioned specifically in a comment, you receive an email notification. The email is titled `[Sigma Computing] New Mention on <workbook name>`.

## Related resources

* [Capture and annotate images in comments](/docs/annotate-element-images-as-comments)
* [Get started in Sigma with view access](/docs/get-started-with-view-access)