> ## Documentation Index
> Fetch the complete documentation index at: https://aspect.inc/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Commenting

> Leave precise feedback on videos, images, and documents.

Comments keep feedback attached to the content being reviewed. External reviewers can comment through a [share link](/docs/share-and-present/sharing-and-permissions) when commenting is enabled.

## Approve a comment

Mark a comment as approved to record agreement during a review. Review the comment, its replies, and the relevant media before approving it.

Use a reply when you need to explain the decision or identify a particular revision. If your team also tracks an asset's overall review status, update its custom metadata field separately.

See the [simple review workflow](/docs/workflows/simple-review-workflow) for recording decisions and confirming the final revision.

## Keep comments internal

Turn on **Internal** before adding a comment if the discussion should stay private to your team.

Internal comments are useful when:

* Producers and editors are discussing work in progress
* A team needs to review a concern before replying to a client
* Feedback includes private production details

To create an internal comment:

1. Open comments on the asset.
2. Select **Internal** before submitting the comment.
3. Add the comment as usual.
4. Confirm that the internal state is visible on the comment.

<Note>
  A normal comment may be visible to external reviewers who have comment access. Check the setting before including private information.
</Note>

## Comment on a video

Move to a moment or select a time range, then add your feedback. You can also attach a file, draw on the frame, or make the comment internal.

<iframe src="https://app.aspect.inc/share/12635abb-c1c7-4446-9d22-279b8939669b/embed?controls=true&autoplay=false&loop=false" loading="eager" title="Commenting, version 2" style={{ width: "100%", aspectRatio: "16 / 9", border: 0, borderRadius: "12px", overflow: "hidden", display: "block", background: "#000" }} allow="autoplay; fullscreen; picture-in-picture" allowFullScreen />

Selecting the comment returns playback to the relevant moment or range.

## Draw on a frame

Pause on the frame, mark the relevant area, and add a short explanation. Available markup includes freehand drawing, arrows, boxes, and circles.

<iframe src="https://app.aspect.inc/share/2f27006f-1a04-4311-9dbb-a6f6463046c5/embed?controls=true&autoplay=false&loop=false" loading="eager" title="Draw and comment" style={{ width: "100%", aspectRatio: "16 / 9", border: 0, borderRadius: "12px", overflow: "hidden", display: "block", background: "#000" }} allow="autoplay; fullscreen; picture-in-picture" allowFullScreen />

## Comment on images and documents

For images, select the area you want to discuss. For documents, open the relevant page or highlight a specific passage. The comment stays connected to that location.

## Work with comments

* **Attach a file** to provide a reference image, graphic, storyboard, or other supporting material.
* **Reply** to keep related feedback in one thread.
* **Mention a teammate** with `@` when you need their attention.
* **React** to acknowledge feedback without adding another reply.
* **Edit** your comment when you need to correct or clarify it.
* **Copy a link** to send someone directly to the comment.
* **Resolve** a comment when the change is complete or the discussion no longer needs action.

Resolved conversations remain available in the asset's history and can be reopened.

## Comments and versions

Comments stay with the version where they were created. Reviewers can [compare versions](/docs/review-and-approve/versioning) while keeping each review round connected to the correct media.

## Notifications and permissions

Aspect supports in-app and email notifications for comments, replies, mentions, and conversation updates. Delivery depends on each person's [notification preferences](/docs/workspace-management/notifications).

Commenting is a separate permission. Workspace members receive access through project permissions, while guests receive it through the share link.

<Card title="Sharing and permissions" href="/docs/share-and-present/sharing-and-permissions">
  Control who can view, comment on, and download shared content.
</Card>

## Use Aspect Agent with comments

Aspect Agent can search comments, summarize feedback, and post or reply to comments on your behalf.

For example:

* `What feedback have people left on this cut?`
* `Find every unresolved comment about the logo.`
* `Leave a comment asking the editor to check the color grade.`

Review the selected assets and proposed comment before approving an action.

<Card title="Aspect Agent" href="/docs/asset-intelligence/ask-aspect">
  Search feedback and complete multi-step review workflows.
</Card>

## Comments in archived projects

Browser previews and comments remain available when media is archived. You can read, add, reply to, resolve, and share comments without restoring the source media.

Mounted-drive access requires Active Storage. Archiving a project leaves its storage tier unchanged; see [storage tiers and archiving](/docs/concepts/core-concepts#archiving-a-project).

## Related guides

<CardGroup cols={2}>
  <Card title="Viewer and review" href="/docs/review-and-approve/viewer-and-review">
    Play media, inspect transcripts, and review versions.
  </Card>

  <Card title="Version Stacks" href="/docs/review-and-approve/versioning">
    Compare revisions while keeping feedback with the correct version.
  </Card>

  <Card title="Sharing and permissions" href="/docs/share-and-present/sharing-and-permissions">
    Send content to external reviewers with controlled permissions.
  </Card>

  <Card title="Aspect Agent" href="/docs/asset-intelligence/ask-aspect">
    Search comments, summarize feedback, and post replies.
  </Card>
</CardGroup>