Annotations and Comments

Pin feedback directly on your designs with annotations, threaded comments, status tracking, and labels.

Annotations are the primary way to leave feedback in Sitemarks. Each annotation is a precise marker placed directly on a markup — a pin at a specific point or a box around a region — with a threaded conversation attached. Together, annotations and comments turn static assets into structured, actionable review sessions.

Creating annotations

Open any markup and select an annotation tool from the toolbar:

• Pin — Click a single point on the canvas. A numbered pin appears at that location, positioned precisely so it stays accurate regardless of zoom level or screen size.
• Box — Click and drag to draw a rectangle around the area you want to highlight. Useful for calling attention to a region rather than a single element.

For PDF markups, annotations are anchored to a specific page number. For video markups, annotations capture the current timestamp so reviewers can jump directly to the relevant frame.

Once you place an annotation, a comment input appears automatically. Type your initial feedback and press Enter to save. The annotation is now visible to everyone with access to the markup.

The annotation sidebar

The annotation sidebar lists every annotation on the current markup in a scrollable panel. Each entry shows the annotation number, the author, the creation date, and a preview of the first comment. Clicking an entry pans the viewer to center on that annotation.

From the sidebar you can:

• Filter by status to see only open, in-progress, in-review, or resolved annotations.
• Filter by assignee to focus on feedback assigned to a specific team member.
• Sort by newest, oldest, or status.
• Toggle resolved to show or hide annotations that have already been closed.

Threaded comments

Each annotation has its own comment thread. Team members can reply to continue the conversation, and threads support:

• Rich text — Format comments with bold, italic, code, and links.
• @mentions — Type @ followed by a team member's name to notify them directly. Mentioned users receive an in-app notification and, depending on their preferences, an email notification as well.
• Attachments — Upload files (images, documents, or other references) directly in a comment. Attachments are stored securely and accessible to anyone with permission to view the annotation.
• Internal comments — Mark a comment as internal to keep it visible only to organization members. External reviewers accessing the markup via a share link will not see internal comments.

Status workflow

Every annotation follows a four-stage workflow:

| Status | Description | |--------|-------------| | Open | Default state when an annotation is first created. Indicates unaddressed feedback. | | In Progress | Work has started on this item. Typically set by the assignee. | | In Review | The fix or change is ready for the reviewer to verify. | | Resolved | The feedback has been addressed and verified. Resolved annotations are hidden by default in the sidebar. |

You can change an annotation's status from the sidebar, the annotation popover, or in bulk using the bulk action bar. Status changes appear in the comment thread so everyone can see the full history.

Severity and priority

For teams that need more granular triage, each annotation supports optional severity and priority fields:

• Severity: Critical, Major, Minor, Trivial
• Priority: Urgent, High, Medium, Low

These fields are available in filters and can be used to sort the sidebar, making it straightforward to address the most important feedback first.

Assignees

Assign an annotation to a specific team member to make ownership explicit. The assignee appears on the annotation badge in the sidebar and can filter their assignments across all markups from the board view.

Labels

Labels are organization-wide, color-coded tags that you can attach to annotations for categorization. Common examples include "Bug", "Design", "Copy", or "Accessibility". Labels are managed at the organization level in settings, and any label can be assigned to any annotation across all projects.

You can filter annotations by label in the sidebar and on the board to slice feedback by category.

Bulk actions

When you need to update multiple annotations at once, select them using the checkbox on each annotation row in the sidebar. The bulk action bar appears at the bottom of the screen and lets you:

• Change status — Move all selected annotations to a new status in one click.
• Assign — Set the same assignee for the entire selection.
• Apply labels — Add or remove labels across the batch.
• Delete — Remove all selected annotations permanently.

Integration with external tools

Annotations can be linked to external issues in Linear, GitHub, Jira, or Slack. When a linked issue is updated in the external tool, the annotation status in Sitemarks can be kept in sync automatically. See the Integrations section for setup details.