Local storage

By default, the JSON representation of your workspace is stored on our servers. If you would rather not upload your software architecture model to our servers, and you're a paid plan customer, you can use the local storage feature to retain all of your data in your local web browser. This feature is only available for workspaces that you own.

Using local storage

To use the local storage feature, you first need to create and upload an empty workspace in Structurizr. For example, with Java:

StructurizrClient structurizrClient = new StructurizrClient("key", "secret");
structurizrClient.putWorkspace(1234, new Workspace("My workspace", "Some description."));

Alternatively you can use the button on your dashboard.

When you open this workspace in Structurizr, instead of being presented with an empty collection of diagrams, you will see this.

Client-side import

Dragging a local file (that contains a JSON workspace definition) into the top part of the page will import it into Structurizr. This only imports the JSON into the web browser, no data is uploaded to our servers. You can then proceed to modify the diagrams as usual. To save the diagrams (and the layout of elements), you have two choices.

1. Save to local storage

The first option is to save the workspace to local storage in your web browser using the button. By doing this, your workspace will be loaded from local storage next time you open the workspace using the same web browser.

The workspace can be removed from local storage by clicking the button while viewing the diagrams.

2. Export from the web browser

The second option is to export the JSON from your web browser so that you can copy-paste it into a file on your local filesystem. You can do this by clicking the button when viewing the diagrams.