Diagram review

Structurizr's diagram review feature allows you to package up one or more diagrams for review by other people. It's designed to offer a quick and lightweight immutable review process, so there's no support for "resolving" comments, or having threaded discussions, for example. It's ideal for a quick general diagram review, a remote risk-storming session, or a STRIDE review. The review feature can be used with diagrams from your workspace, or any other PNG/JPG files.

Cloud service paid feature

A diagram review of a hand-drawn software architecture diagram
Demo

Creating a review from diagrams in a workspace

While viewing the diagram viewer/editor (with a /workspace/... URL, not a /share/... URL), click the button to open the review modal, from where you can select one or more diagrams to be included in the review.

Creating a review from a workspace
A diagram review of a workspace diagram

Diagram reviews from workspaces can be created as "public" or "private":

  • Public: The diagram review will be accessible by unauthenticated users.
  • Private: The diagram review will be accessible in accordance with the workspace sharing and workspace security settings:
    • Private - The diagram review will be accessible by authenticated users, if they have access to the workspace via the role-based access mechanism.
    • Public - The diagram review will be accessible by unauthenticated users.

Creating a review from other diagrams

You can also create a review using other PNG/JPG files using the link below (you need to have an account, and be signed in), or the link on your dashboard.

Creating a review from other diagrams
A diagram review of a hand-drawn software architecture diagram

Sharing the review, and commenting

Each review has a unique URL (e.g. https://structurizr.com/review/{token}), which you'll be forwarded to after creating the review. This URL can be given to anybody who you'd like to comment on your diagrams.

Each time somebody visits your review page, they will start a review session in which comments can be added. Click the mouse somewhere on the diagram, and a modal window will open for a new comment. Comments can be moved around the diagram by dragging them, and edited by clicking on them. To delete a comment, just remove its text.

New comments created during that review session can be submitted by clicking the button.

Once submitted, comments cannot be modified.

Additional notes

  • Cloud service: If a user is signed in to Structurizr, the comment author will be the name in their user profile. If not signed in, or no name is set, the comment author will be anonymous. As the review creator, you will receive an e-mail notification when new comments are received.
  • On-premises installation: If a user is signed in to Structurizr, the comment author will be their username. If not signed in, the comment author will be anonymous.

Locking and unlocking the review

The creator of the review can lock/unlock the review, to prevent/allow new comments. Click the and buttons respectively.

Notes

Diagram reviews can include up to 10 diagrams, with a combined limit of 5MB.