> For the complete documentation index, see [llms.txt](https://docs.scaleflex.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scaleflex.com/digital-asset-management-dam/library/assets/asset-details-window/asset-information-tabs/comments.md). # Comments Comment on images and videos, and draw on them to show exactly what you mean The **Comments** tab lets you discuss an asset with your team directly on the media. You can draw shapes or drop a pin on an image or a video, attach a comment to it, mention colleagues, and track each discussion until it is resolved. ## Key use cases * Requesting changes to a design ("*Move the logo to the top-right corner*"). * Pointing out a specific area of a product photo that needs retouching. * Reviewing a video and leaving feedback at an exact moment. * Collecting feedback from several reviewers in one place. ## Supported assets | Asset type | What you can do | | ----------- | ---------------------------------------------------------------------------------------------------- | | Images | Text comments, drawings and pins | | Videos | Text comments, drawings and pins, linked to a moment in the video (MP4, MOV, WEBM, MKV, AVI and 3GP) | | Other files | Text comments only | ## Opening the Comments tab Open an asset to display the [Asset Details window](/digital-asset-management-dam/library/assets/asset-details-window.md), then click the **Comments** tab. When the Comments tab opens: * The drawing toolbar appears below the media. * The comments panel lists all comments on the asset. * A playing video is paused, so you can start reviewing straight away.
You can also reach a comment from a notification. When someone mentions you, replies to your comment or likes it, click **See comment** in the notification. The asset opens on the Comments tab with that comment selected. On a video, the player also jumps to the moment of the comment. {% hint style="info" %} The Comments tab is available to signed-in users only. {% endhint %} ## Drawing tools | Tool | Description | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Freehand** | Draw freely on the media. This is the default tool. | | **Pin comment** | Click anywhere on the media to drop a numbered pin. | | **Shapes** | Choose from Arrow, Double arrow, Line, Rectangle, Rectangle (filled), Ellipse and Ellipse (filled). | | **Appearance** | Pick a colour from the palette or enter a custom hex value, and adjust the stroke size and opacity. The default colour is your project's brand colour. | | **Undo** / **Redo** | Undo or redo shapes you have not sent yet. Sent comments are never changed by Undo or Redo. | Your selected tool and colour stay the same while you remain on the Comments tab. ## Adding a comment ### Comment on an area of the media 1. Select a drawing tool, or **Pin comment**. 2. Draw on the media, or click where you want to place the pin. 3. In the popup that appears, type your comment. 4. Click **Send**, or press **Enter**. To mark several areas in one comment, click **Draw more** in the popup instead of typing. Keep drawing, then write your comment in the box at the bottom of the comments panel and click **Send**. While you are drawing more shapes, the panel lists them under **Pending shapes**. Click **Clear** to discard them and start again. {% hint style="info" %} A comment always needs text. Drawings and pins on their own cannot be sent. {% endhint %} To discard a drawing before sending it, click **Cancel** in the popup or press **Esc**. ### Text-only comment Type in the **Leave your comment here...** box at the bottom of the comments panel and click **Send**. On a video, the comment is linked to the current moment of the video. ### Mentions and emoji * Type **@** to mention a project member. Keep typing to filter the list by name or email, then select a person. They receive a notification. * Click the **Emoji** button to insert an emoji. * Press **Shift + Enter** to add a new line without sending. ## Managing comments Each comment shows its author, when it was posted, and whether it is **Open** or resolved. Click a comment to show its drawing on the media. From the comment, you can: * **Like** a comment, or click again to unlike it. * **Subscribe** to a comment to follow the discussion, or click again to unsubscribe. From the **More actions** menu of a comment, you can: * **Reply**: start a threaded reply. Replies support mentions and emoji, but not drawings. * **Resolve** / **Reopen**: mark the discussion as resolved once the feedback has been handled, or reopen it. Resolving a comment resolves its whole thread. * **Edit**: change the text of your comment. Edited comments are marked as **Edited**. * **Delete**: remove a comment after confirming. Deleting a comment also deletes all its replies. This cannot be undone. You can also press **Delete** or **Backspace** to delete the selected comment, if you have the right to delete it. You are always asked to confirm first. ### Filtering and sorting Use the buttons at the top of the comments panel to show **All**, **Open** or **Resolved** comments. Use the **Sort** menu to order comments by: * **Newest first**: the default for images. * **Oldest first**. * **Timeline**: videos only, and the default for videos. Orders comments by their moment in the video, so comments made at the same moment appear together. ## Comments on videos On videos, every comment is linked to the moment of the video at which it was made. The time is displayed in the comment, for example **1:05**. * **Markers on the progress bar**: each comment appears as a marker above the video's progress bar. Red markers contain open comments, and green markers contain only resolved ones. * **Grouped markers**: comments made within the same second are grouped into one marker, which shows how many comments it contains. * **Preview**: hover over a marker to preview the first comment. The matching comments are highlighted in the panel. * **Jump to a comment**: click a marker, or a comment in the panel, to pause the video, jump to that moment and show the comment's drawing. Clicking a reply jumps to the moment of the original comment. * **Pins during playback**: when the video reaches the moment of a comment, its pin appears briefly over the video, whether the video is playing or paused. Drawing or placing a pin pauses the video automatically. Sending a comment does not resume playback. ## Fullscreen mode For a larger workspace, click **Fullscreen** on the right of the drawing toolbar. The media, the toolbar and the comments panel open across the whole screen, and all your comments and unsent drawings carry over. On images, you can also zoom with the mouse wheel in fullscreen mode. To leave, click **Exit fullscreen** or press **Esc**. ## Keyboard shortcuts Shortcuts do not apply while you are typing in a comment box. | Shortcut | Action | | ------------------------------------ | --------------------------------------------------- | | **1** | Freehand | | **2** | Pin comment | | **3** | Rectangle | | **4** | Ellipse | | **5** | Arrow | | **6** | Line | | **Ctrl + Z** (**⌘ + Z** on Mac) | Undo | | **Ctrl + Y** or **Ctrl + Shift + Z** | Redo | | **Esc** | Cancel the current drawing, or exit fullscreen mode | | **Delete** / **Backspace** | Delete the selected comment (after confirmation) | | **Enter** | Send a comment | | **Shift + Enter** | Add a new line in a comment | ## Permissions All users who can view an asset can comment on it. | Action | Who can do it | | ------------------------------------ | --------------------------------------------------- | | Add comments, reply, like, subscribe | All users who can view the asset | | Edit a comment | The comment's author only | | Resolve, reopen or delete a comment | The comment's author, and Owners and Administrators | See [Standard user levels](/vxp-visual-experience-platform/settings/organisation/users/users.md#standard-user-levels) for more about user levels. ## Comments made before the update Comments and drawings made with the previous version of the annotator are kept and displayed with the new tools. Each older drawing gets a numbered pin, so it looks and behaves like a new comment.