Skip to main content

Comment on a diagram

Comments pin feedback to a specific place in a diagram — especially useful during review cycles. Commenting never requires checking the diagram out, and it has its own permissions, so reviewers can comment without being able to edit.

Prerequisites​

  • The Add Diagram Comments item permission to comment (viewing others' comments needs it or View All Diagram Comments). Editing, moving, deleting, and resolving comments have their own permissions — Modify Own / Delete Own / Move Any / Delete Any / Resolve/Reopen Own / Resolve/Reopen Any Diagram Comments — see Roles and Permissions.

Steps​

Add a comment​

  1. Open the diagram and select the Add comments tool in the toolbar.
  2. Click the shape the comment belongs to, or an empty spot on the canvas. The comment opens with the input field ready — type and save.

A comment on a shape moves with the shape; a comment on the canvas stays in place. A comment indicator appears at that location; pointing at it shows the comment.

Attach, detach, or delete a comment​

Right-click a comment indicator to open its own menu, which holds Mark As Read or Mark As Unread, plus Delete and Detach From Shape where they apply to that comment.

  • Attach — drag a comment that sits on the canvas onto the shape it belongs to. iGrafx highlights the element under the pointer while you drag, and the comment attaches to it when you drop it. For a pool, a lane, or a phase, drop the comment on that element's header band; its body isn't a target, so the shapes inside a pool stay reachable.
  • Detach From Shape — returns the comment to the canvas. It appears only when you can move the comment, and never on a reply or a resolved comment.
  • Delete — removes the comment; selecting a comment and pressing Delete or Backspace does the same.

Discuss and resolve​

  • Reply to a comment to keep the discussion in one thread — the send button at the bottom of the thread, next to the input field; the comment shows its reply count.
  • Unread comments show a bold headline, and opening a comment marks it read. To set one back, use Mark As Unread in the three-dot menu at the top of the comment.
  • Resolve closes a comment — the checkmark button at the top of the thread; it shows who resolved it and when, and the same button reopens it. Edited comments are marked Edited.

Review all comments​

Open the Comments panel in the side toolbar to see every comment on the diagram, filtered to Open by default — clear the filter to include resolved ones. Selecting a comment takes you to its place in the diagram.