Mermaid reference: data and security
On this page
What is stored
Each diagram's saved settings are the macro's configuration. They live in the page body and in each page version.
| Key | Holds |
|---|---|
source | The diagram's text |
theme | The Colours setting |
look | The Look setting, when it is not Classic: handDrawn or neo. Since 2.9. |
layout | The Layout setting, when it is not Standard: elk. Since 2.9. |
size | The Size on the page setting: auto, fit or actual. Diagrams saved before 2.8 have none and read as auto. |
alt | The alt text |
lang | Which item the diagram is: plantuml or openapi. Mermaid diagrams have none, as they never have. |
history | Up to five earlier versions, each its text and time |
png, pngW, pngH | The export picture and its size in CSS pixels |
pngKey | A key made from the Colours setting and the source, and from Look and Layout when either is not the default, so a picture is never used for text or settings it was not drawn from. At the default Look and Layout it is the key every earlier version computed. For a source that sets its own theme or colors, 2.6 changed the key, so a picture saved before no longer matches. |
pngBy | Which Mermaid drew the picture: 12.3 since 2.9, and nothing on a picture saved before. Exports do not read it. A save does, to draw again a picture an earlier Mermaid drew. |
Each picture is up to about 73 kB, so 30 diagrams at the cap add about 3 MB to a page. The app uses no Forge storage, and Eriksen Labs holds no copy.
Separately, the editor remembers a click in the browser's own
storage (localStorage, in the editor's frame), and only a click:
Dismiss on the evaluation note, in
mermaid-diagrams.evaluation-note (that it was
dismissed), and Not now or Rate it on the rating line, in
mermaid-diagrams.rate-ask (how many Not nows, when the
last was, and whether Rate it was clicked). Opening the editor,
saving and showing a line write nothing. Nothing stored there is
about you or your diagrams, and none of it is sent anywhere. The
app never removes these values, so uninstalling it leaves them in
the browser. See
The evaluation note and the rating line.
Security
- The app requests no permission scopes and declares no egress.
-
Mermaid runs at
securityLevel: 'strict', which the app never relaxes. Labels are sanitized. -
Links are
httpandhttpsonly, and open through Confluence. - Paste clean-up runs in the browser. A pasted diagram link is read from its own text and never opened.
- Version 2.9.0 includes Mermaid 12.3.0 and DOMPurify 3.4.17, with no advisory of any rating open in the code the browser receives. The trust center has the details.
- The export function keeps nothing, makes no network calls and logs only an error's name; see Exports.
- Draft with AI and Fix with AI copy a prompt to the clipboard. The app sends nothing to any AI.
- An OpenAPI description is read in the browser by the app's own code, with js-yaml 5.5.0 (MIT) for YAML. Every word in it is shown as text, never as markup, and a reference to another file or a web address is named, never fetched. Size, depth and the work done on one description are limited, so a description cannot slow the page down. See Where your description goes.
Read our security policy and privacy policy.