> For the complete documentation index, see [llms.txt](https://help.dscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dscout.com/getting-started/collaborate-in-dscout/builder-comments.md).

# Builder comments

Comments let you leave feedback directly on a screener or study. You can attach comments to specific questions, mention your collaborators directly, and mark comments as requiring a resolution before the study can be launched.

You can access a screener or study’s comments by clicking the **Comments (speech bubble)** icon at the top of the builder:

{% hint style="info" %}
In diary studies, click **Comments** (no icon) at the top of the builder.
{% endhint %}

![](/files/b52d67222a53e854f8fe0b67df846bc0ddb5078b)

If a specific question has comments, you’ll see a yellow icon with the number of comments on the question itself. Click this icon to view the question’s comments:

![](/files/ccf22add7362737d3e95b3702854dbb96518d839)

## Add a comment

When leaving comments, you can leave them on the study generally or attach them to specific questions. You can also tag collaborators to ensure they see your notes. Tagged collaborators receive an email notification letting them know you mentioned them.

{% stepper %}
{% step %}
Click the **Comments (speech bubble)** icon at the top of the builder. All unresolved comments are displayed.

{% hint style="info" %}
In diary studies, click **Comments** (no icon) at the top of the builder.
{% endhint %}

![](/files/b52d67222a53e854f8fe0b67df846bc0ddb5078b)
{% endstep %}

{% step %}
Click **+ New comment** at the bottom of the comments sidebar. A text box is displayed.

![](/files/1b7987e6da8a33faa28318aa245895a6435195eb)
{% endstep %}

{% step %}
Type your comment in the text box.
{% endstep %}

{% step %}
(Optional) Select **Must be resolved to launch** if your comment requires action before the screener or study may be launched.

{% hint style="info" %}
If the screener or study has already been launched, this setting will be disabled.
{% endhint %}

![](/files/a28dd719c261a361bc3db30b905151e163eebd43)
{% endstep %}

{% step %}
(Optional) Type **@** followed by a collaborator’s name to mention them in the comment.

![](/files/77e913a404cdc019fe8b34784d1b84d313474ae9)
{% endstep %}

{% step %}
Click **Comment**.
{% endstep %}
{% endstepper %}

Now, your comment is added to the study. If you selected **Must be resolved to launch**, the screener or study cannot be launched until the comment is resolved. (For more information, see [Resolve a comment](#h_01KPXH5DCH12QWA73BTVY124YG).) If you mentioned a collaborator, they’ll receive an email notification letting them know.

To add a comment to a specific question, hover over the question and click the **Comments (speech bubble)** icon:

{% hint style="success" %}
In diary studies, you can highlight specific question text and comment directly on it.
{% endhint %}

![](/files/ccf22add7362737d3e95b3702854dbb96518d839)

## Resolve a comment

Once a comment has been addressed, you can resolve it. Some questions may be marked as **Must be resolved to launch**. Those questions *must* be marked as “resolved” directly in the builder before the screener or study can be launched.

{% stepper %}
{% step %}
Locate the comment in your screener or study.
{% endstep %}

{% step %}
Click the **checkmark** icon in the top right corner of the comment.

{% hint style="info" %}
Only the original comment in a thread contains this checkmark icon. If you don’t see it, make sure you’re looking at the top comment, not a reply. In diary studies, you'll see the word **Resolve** instead of an icon.
{% endhint %}

![](/files/aac1e22dc7965c50b787df6ac542b9590d45074e)
{% endstep %}
{% endstepper %}

Now, the comment is marked as resolved. You can view any previously resolved comments by applying the **Resolved** filter in the comments sidebar. For more information, see [Filter comments](#filter-comments).

## Reply to a comment

If you’ve been mentioned in a comment (or feel like chiming in anyway!), you can reply to start a thread.

{% hint style="info" %}
Notifications are only sent if you mention a collaborator directly using **@** followed by the collaborator’s name. They will not receive a notification for replies to their comments alone.
{% endhint %}

{% stepper %}
{% step %}
Locate the comment you want to reply to.
{% endstep %}

{% step %}
Click **Reply**. A text box is displayed.

![](/files/af69c893d116f6ea6a383c01fd10fdf3db6b27c3)
{% endstep %}

{% step %}
Type your response.
{% endstep %}

{% step %}
(Optional) Type **@** followed by a collaborator’s name to mention them in the comment.
{% endstep %}

{% step %}
Click **Done**.
{% endstep %}
{% endstepper %}

Now, your reply is posted. Anyone you mentioned will receive an email notification. You can edit or delete your replies on unresolved comments, too. For more information, see [Edit a comment](#edit-a-comment) or [Delete a comment](#delete-a-comment).

## Filter comments

When viewing comments, you may wish to filter them to find those relevant to you. Comments have the following filter options:

* **Unresolved:** Displays only comments that have not been resolved. This filter is applied by default.
* **Mentions:** Displays only comments that you have been mentioned in.
* **Must be resolved:** Displays only comments that require attention prior to launching the screener or study.
* **Resolved:** Displays only comments that have already been resolved.

Comment filters can be accessed by clicking the drop-down at the top of the comments sidebar:

![](/files/2b7eabb48102f0db91e53cf7b1c002cf4bff0af3)

## Edit a comment

If you want to modify a comment you’ve already left on a screener or study, you can do so. You can edit the comment itself, add collaborator mentions, and change whether a comment must be resolved or not prior to launch.

{% hint style="info" %}
Resolved comments cannot be edited. Additionally, you can only edit comments you’ve left, not comments left by your collaborators.
{% endhint %}

{% stepper %}
{% step %}
Locate the comment in your screener or study.
{% endstep %}

{% step %}
Click the three-dot icon in the top right corner of the comment.
{% endstep %}

{% step %}
Click **Edit**. A text box is displayed.

![](/files/a55cf49b70794776034658850d2db7fc5743ed83)
{% endstep %}

{% step %}
Make the required edits.
{% endstep %}

{% step %}
Click **Done**.
{% endstep %}
{% endstepper %}

Now, the edits to your comment are saved. Any new collaborators you’ve mentioned will receive an email notification.

## Delete a comment

If a comment is no longer needed, you can delete it.

{% hint style="info" %}
Resolved comments cannot be deleted, nor can comments with replies. Additionally, you can only delete comments you’ve left, not comments left by your collaborators.
{% endhint %}

{% stepper %}
{% step %}
Locate the comment in your screener or study.
{% endstep %}

{% step %}
Click the three-dot icon in the top right corner of the comment.
{% endstep %}

{% step %}
Click **Delete**.

![](/files/327b072a53e6c6bebf8d9afcdb57074924d633c6)
{% endstep %}
{% endstepper %}

Now, your comment is deleted.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.dscout.com/getting-started/collaborate-in-dscout/builder-comments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.