Post Review & Annotations
Pin feedback directly on images, videos, 3D models, and animations. Annotations let your team review work in context — no more describing which pixel you’re talking about in a text comment.
How Review Works
When a post contains media (images, videos, 3D models, sprite sheets, or animations), you can open the full-screen review viewer by clicking any media item. Inside the viewer, toggle Annotate mode to start pinning feedback directly on the media surface. Each annotation is a comment tied to a specific position — and for videos and animations, a specific moment in time.
Annotations update in real time. When a teammate places a pin, it appears instantly for everyone viewing the same media. A presence indicator in the header shows who else is currently reviewing.
Opening the Review Viewer
Navigate to any post that contains media and click on an image, video, or other media attachment. The review viewer opens as a full-screen overlay with the media centered, a toolbar at the top, a thumbnail carousel at the bottom, and an optional comments sidebar on the right.
- Toolbar
- Close button, file info (current index and filename), presence avatars, zoom controls (for images and 3D), the Annotate toggle, a visibility toggle to show or hide pins, and a button to open the comments sidebar.
- Thumbnail Carousel
- A horizontal strip of thumbnails at the bottom of the viewer. Each thumbnail shows an annotation count badge when it has annotations. Use arrow keys or click to navigate between media items.
- Comments Sidebar
- A 400px panel on the right (desktop) or a bottom sheet (mobile) listing all annotations for the current media item. Click an annotation in the sidebar to highlight its pin on the media.
- Keyboard Navigation
- Press Esc to cancel a pending annotation or close the viewer. ← and → navigate between media items.
Placing an Annotation
Click the Annotate button in the toolbar to enter annotation mode. Your cursor changes to a crosshair. Click anywhere on the media surface to place a pin — a floating composer appears at that position.
- 1.
Enable Annotate Mode
Click the Annotate button in the toolbar. The button highlights to indicate annotation mode is active and your cursor changes to a crosshair.
- 2.
Click to Place a Pin
Click on the area you want to comment on. For videos, the playback pauses automatically and the timestamp is captured. For 3D models, the camera position is saved along with the surface point.
- 3.
Write Your Feedback
A floating composer appears next to the pin. Type your feedback (up to 5,000 characters) and choose a status type from the dropdown. Press Cmd+Enter or click Submit to post the annotation.
- 4.
Cancel If Needed
Press Esc or click the X on the composer to cancel without placing the annotation. The pin disappears and you stay in annotation mode.
Annotation Statuses
Every annotation has a status that communicates the type of feedback. The status determines the color of the pin marker and the badge in the sidebar. You can change the status at any time after creation.
Comment
General feedback or observation. The default status for new annotations.
Needs Changes
Something that must be fixed or revised before the work can proceed.
Approved
Confirms that this part of the work looks good and is ready to ship.
Question
A question about a design choice, implementation detail, or intent.
Suggestion
A non-blocking idea or improvement that the author can consider.
Resolving Annotations
When feedback has been addressed, mark the annotation as resolved. Resolved annotations become semi-transparent on the media surface and show a green checkmark instead of their status icon. This makes it easy to see what’s been handled and what still needs attention.
To resolve an annotation, open its action menu (three-dot icon) in the sidebar and select Resolve. To reopen it, select Reopen from the same menu. The annotation author, the post author, and workspace admins can resolve or reopen annotations.
Supported Media Types
Spatial annotations work with most media types in Project Feed. Each type captures different contextual data along with the pin position.
Images
Click anywhere on the image to place a pin. The annotation is stored as a percentage position (X, Y) so it stays accurate regardless of zoom or screen size.
Videos
Click on the video to place a pin at a specific frame. The video auto-pauses and the current timestamp is captured. Annotations only appear on the timeline when playback is within two seconds of their timestamp.
3D Models
Click on the surface of the model to place a pin. The camera position and look-at target are saved, so reviewers can restore the exact viewpoint later. Markers track the 3D surface as you orbit the model.
Sprite Sheets
Click on a sprite frame to annotate it. In full-sheet mode, the specific frame is identified from the grid position. In single-frame playback mode, the current frame is captured.
Rive Animations
Click on the animation canvas to place a pin. The animation pauses and the current frame is captured, similar to video annotations.
Audio
Audio files can be played in the review viewer but do not support spatial annotations since there is no visual surface to pin to.
Pin Markers
Annotation pins are colored circles positioned on the media surface. Their color matches the annotation status (amber for comments, orange for needs changes, green for approved, blue for questions, purple for suggestions). Resolved annotations show a green checkmark at reduced opacity.
- Image & Sprite Pins
- Positioned at a fixed percentage of the media dimensions. They stay accurate regardless of zoom level or screen size.
- Video Pins
- Only visible when playback is within two seconds of the annotation’s timestamp. Colored pips also appear on the video timeline scrubber.
- 3D Model Pins
- Projected from 3D world coordinates to screen space in real time. Pins track the model surface as you orbit. A camera icon indicates a saved viewpoint that can be restored on click.
- Visibility Toggle
- Click the eye icon in the toolbar to hide all pins temporarily. Useful when you want to see the media without visual clutter.
Replies & Threads
Annotations support threaded replies. Click Reply on any annotation in the sidebar to add a follow-up. Replies are indented under the parent annotation with a visual connector line, creating a clear conversation thread tied to a specific spot on the media.
Both annotations and replies support emoji reactions, so teammates can acknowledge feedback without adding another comment.
Annotation Actions
Each annotation has a three-dot action menu in the sidebar with the following options:
Change the annotation text. Only available to the author.
Switch between Comment, Needs Changes, Approved, Question, and Suggestion. Available to the author, post author, and admins.
Mark as addressed. The pin becomes semi-transparent with a green checkmark. Available to the author, post author, and admins.
Undo a resolve if the feedback still needs work. Same permissions as resolve.
Permanently remove the annotation and all its replies. Available to the author and workspace admins.
Review Summary
Below the media carousel on the post page, a review summary widget shows the total annotation count, how many are unresolved, and a per-status breakdown. When all annotations are resolved, an “All resolved” indicator appears in green.
For posts with multiple media items, the summary also shows per-media rows with a “Click to review” link that opens the viewer directly to that item.
Real-Time Presence
When multiple people are reviewing the same media item, their avatars appear in the toolbar header. This lets you know who’s actively looking at the same file, making live review sessions more collaborative. Presence updates in real time as people open and close the viewer.
Tips & Best Practices
Use Statuses Intentionally
“Needs Changes” signals a blocker. “Suggestion” signals a nice-to-have. Using the right status helps the author prioritize which feedback to address first.
Resolve as You Go
After addressing feedback, resolve the annotation so reviewers can see at a glance what’s been handled. The summary widget tracks unresolved count automatically.
Be Specific with Pins
Place the pin directly on the element you’re referencing. A pin on the exact button, pixel, or surface beats a general comment that says “the thing on the left.”
Use 3D Viewpoints
When annotating 3D models, the camera position is saved with each pin. Reviewers can click a pin to restore the exact angle you were looking at, eliminating guesswork about which part of the model you meant.
Use Video Timestamps
Video annotations capture the exact frame. The timeline scrubber shows colored pips for each annotation, so reviewers can scrub to feedback points without reading through every comment.
Hide Pins When Needed
Toggle the eye icon in the toolbar to hide all pins temporarily. This is useful when you want to evaluate the media without annotation markers covering the content.
The Comments Sidebar
Click the comments icon in the toolbar to open the sidebar. It lists all annotations for the current media item, each showing the author, timestamp, status badge, content, and any replies. Clicking an annotation in the sidebar highlights its pin on the media.
On mobile, the sidebar appears as a bottom sheet (up to 70% of the screen height) instead of a side panel.