# Comments

Comments allow users to collaborate by attaching notes directly to specific locations on the map. Whether you're reviewing analysis, coordinating planning, or gathering feedback from teammates, comments keep the conversation tied to the data—exactly where it matters.

Each comment supports:

* Threaded replies
* `@mentions` to notify specific users
* Direct links for easy sharing
* Location and zoom-level persistence

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-58c15e426af79d8339841d9520cd208494911001%2Fcomments.gif?alt=media" alt=""><figcaption></figcaption></figure>

### Adding comments

Adding comments is simple and it has been designed to foster user collaboration:

1. Locate the area of interest on the map.
2. Click the **Add comment** button.
3. Click on the specific point where you want to leave a comment.
4. Type your message and press **Enter** to create a new comment thread.

{% hint style="info" %}
**Editor users** can always comment.

**Viewer users** can comment too—but only if enabled by an Editor user in **Map settings for viewers**.
{% endhint %}

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-32d936b2b401d3d1c1f5e95a74cd4e0fef7d829b%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Comment notifications

When a comment is posted, an email is automatically sent to:

* The **map owner**.
* All participants in the thread.
* Any **@mentioned** users — *only if they already have access to the map.*

Each email includes a direct link to the comment for quick access.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-33fd73c25f98f7b88976eae2818a9e0994f4ae97%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Resolving comments

* Click **Resolve** to archive a comment in the *Resolved* view.
* Click **Reopen** to bring it back to the active discussion.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-0a6189ca2c2a375a4b1a452dd72dc06ddfa072ba%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Comments panel

The right-side Comments panel gives you full control over collaboration:

* **Real-time updates -** new comments appear instantly both in the panel and directly on the map (no need to reload).
* **Search bar** to find comments by keyword or author.
* **Unread indicators** to track new threads or replies.
* **Mark all as read** functionality located at the bottom right corner allows you to mark all your comments as read![](https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-2ac255aaa3db6c0a01f405a2fb99011261b31a47%2Fimage%20\(715\).png?alt=media).
* **Filters**:
  * *All comments*
  * *Only unread*
  * *My comments*
* **Visibility toggle** to hide/show comments on the map.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-7ff5f8059ba834b202cbcfdc4fb00dc82d1ee40b%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Comment permissions

* Only **logged-in users with access to the map** can add or reply to comments.
* You can only `@mention` users who already have access to the map.
* **Anonymous users** in public maps cannot view, post, or be mentioned in comments.

### Comments on published maps

Comments are **disabled by default** on published maps. To enable them:

1. Open the **Map settings** **for viewers**.
2. Enable the **Comments** functionality.

Once enabled:

* Logged-in Viewers with access can add and reply to comments.
* Anonymous/public users **cannot** see or interact with comments.

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-6509e01ac9ea6a048e9b2285d5638a3490ebf50f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Comments in Split View maps

Comments retain:

* Latitude, longitude, and zoom level.
* The **side of the split view** where they were added.

When switching views:

* **Split → Single view**: You’ll be prompted to merge comment threads into the main view
* **Single → Split view**: New comments will default to the **left map.**

<figure><img src="https://3029946802-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FybPdpmLltPkzGFvz7m8A%2Fuploads%2Fgit-blob-34815d1c2be0f5e91db1a6ffae8016c428049e89%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Duplicating Maps

When you duplicate a map, existing comments are *not copied*. The new map starts without any comment threads.
