# Test case comments

> Discuss, reply, pin, and mention teammates on a test case; the same thread experience also powers defect comments.

Each test case has a **Comments** tab where team members discuss the case: reply in threads, pin key context to the top, and mention teammates. Comments appear in the activity feed and are scoped to the organization. Defect detail pages and [test case review requests](https://docs.probara.net/en/guides/test-case-review/#comments-on-a-request) use the exact same comment thread experience described here.

## Permissions

| Action                          | Required role                |
| ------------------------------- | ---------------------------- |
| Read comments                   | Viewer, Member, Admin, Owner |
| Add a comment or reply          | Member, Admin, Owner         |
| Edit your own comment           | Member, Admin, Owner         |
| Delete your own comment         | Member, Admin, Owner         |
| Delete any comment (moderation) | Admin, Owner                 |
| Pin or unpin any comment        | Member, Admin, Owner         |

Viewers can read the thread but cannot post, edit, delete, pin, or unpin. They never see the **More actions** menu.

## Adding a comment

1. Open the test case detail panel or expanded view.
2. Click the **Comments** tab — the badge next to the label shows the current count.
3. Type your message in the composer at the bottom of the thread. A comment can hold formatting and images: paste or drop an image into it, or type **/** and choose **Image**. Use **@** to mention a teammate (see [Mentions](#mentions)).
4. Click **Comment**, or press **Ctrl+Enter** or **Cmd+Enter** to submit (**Enter** starts a new line).

## Replying to a comment

Point at a comment (or tab to it) to show its **Reply** and **More actions** (⋯) buttons; on a touch screen they are always visible. Click **Reply** to open a reply composer under the comment's replies. Replies are one level deep — you cannot reply to a reply — and always stay listed under their comment.

## Sorting the thread

Click the sort toggle above the thread to switch between **Oldest first** (default) and **Newest first**. Your choice is remembered on this device across every comment thread you open. Replies always stay in chronological order under their parent, regardless of the sort you pick for top-level comments.

## Pinning a comment

Open the **More actions** (⋯) menu on a top-level comment and choose **Pin comment**. Pinned comments sit above the sorted feed as a one-line **Pinned** strip with the author and the start of the comment; click the strip to expand the full comment, its replies, and who pinned it ("Pinned by \{name\}"). Any member can pin or unpin any comment — pinning is not limited to your own comments. Only top-level comments can be pinned; a reply has no pin option in its menu. There is no limit on how many comments you can pin at once. Choose **Unpin comment** from the same menu to remove it from the pinned set.

## Editing a comment

Open the **More actions** (⋯) menu on your own comment and choose **Edit**. Make your changes and click **Save**; the comment keeps its formatting, images, and mentions. Edited comments display an _(edited)_ marker. Only the original author can edit a comment. Editing a comment re-resolves any `@mentions` in the new text.

## Deleting a comment

Open the **More actions** (⋯) menu on a comment and choose **Delete**. Admins and owners can delete any comment; members can only delete their own. Deleting a top-level comment also deletes all of its replies.

Deleting a comment is permanent and cannot be undone.

## Mentions

Type **@** followed by a few letters of a teammate's name to open an autocomplete list of organization members; select one to insert a mention. Mentioned members are **not** notified by email or in-app — the mention is a visual cue, not an alert. If a mentioned member is later removed from the organization, the mention still renders using their last known display name.

## Cascade delete

When a test case is deleted, all of its comments and replies are permanently deleted as well, together with the comments on its review requests.

## Activity feed

Comment actions (commenting, replying, editing, deleting, pinning, and unpinning) appear in the organization activity feed under the test case entity, including a brief excerpt of the comment body where applicable.