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, or when you want to run a remote risk-storming session. The review feature can be used with diagrams from your workspace, or any other PNG/JPG files.

Demo

A diagram review of a hand-drawn software architecture diagram


Users with free accounts can include a single diagram, while users with paid subscriptions can include up to 10 diagrams (with a combined limit of 5MB).

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

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.

Create a diagram review

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.