# Comments

Comments are conversation threads attached to committed elements. They let reviewers and collaborators capture context, questions, and decisions alongside the diagram data itself.

## Where You See Comments

Comments appear in the **Explorer Panel** (the Model Explorer tab in a board's preview) — in a dedicated **Comments** column next to each element row.

* If an element has no comments, the cell is empty.
* If it has comments, a chip shows the first comment's text with a badge indicating the total count.

<figure><img src="/files/Y4OIDx4t2cfwSJvhvkZi" alt=""><figcaption></figcaption></figure>

## Opening the Full Thread

Click the comment chip on any row to open the **Comments** dialog. The dialog lists all comments for that element:

* **Sorted newest first**
* Each entry shows who wrote it and when (*created by + created date*)
* Entries are scrollable for long histories

## What Comments Are Tied To

Comments are attached to individual **committed elements** — the ServiceNow records behind your shapes. They travel with the record, not with a specific version of the board, so commenters on a shared ServiceNow record see each other's entries regardless of which board they opened.

## Read-Only in the Explorer Panel

In v26, the Explorer Panel shows comments as **read-only**. Adding, editing, or deleting a comment from the Explorer Panel is not available — the dialog is for reading the thread.

Comments are typically added as part of the [Commit](/models/work-in-the-app/editor/commit.md) / Reject flow (where a rejection requires a reason, which becomes a comment on the element).

## Roles & Gating

* Any user who can open the Explorer Panel and see the row can read its comments.
* Adding/editing comments happens through related workflows (rejection, ServiceNow-native commenting on the underlying record).

## Limits & Gotchas

* **Comments column is only visible when at least one element in the grid has comments** — if the column is missing, nothing has been commented yet.
* **You're looking at comments on the underlying record**, not board-specific annotations. Changes made in ServiceNow show up here too.
* **Sort is fixed** — newest first. There's no way to flip to oldest-first in the current dialog.

## Related

* [Commit](/models/work-in-the-app/editor/commit.md) — rejection reasons are saved as comments
* [Data Panel](/models/work-in-the-app/editor/data-inspector.md) — inspect the underlying record
* [Notifications](/models/work-in-the-app/editor/notifications.md) — status updates from commit/reject that reference commented elements


---

# 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.ins-pi.com/models/work-in-the-app/editor/comments.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.