Mermaid: Improper sanitization of `classDef` in state diagrams leads to HTML injectionGHSA-ghcm-xqfw-q4vr
Fix: mermaid-js/mermaid@37ff937GHSA-ghcm-xqfw-q4vr is a Code Injection vulnerability in mermaid. A fix is available for mermaid — see the affected versions and patch details below.
Exploitation Status
Proof-of-concept exploit code exists
- CISA’s SSVC triage found public proof-of-concept exploit code for this CVE, though no confirmed active exploitation.
Exploitation and automatability from CISA’s SSVC triage for GHSA-ghcm-xqfw-q4vr.
EPSS Exploitation Probability
Probability of exploitation in the next 30 days, from FIRST.org EPSS.
Real-World Exposure
How broadly this vulnerability is actually deployed: weekly install volume shows current usage, and reverse-dependency count shows how many other packages break if it stays unpatched.
mermaidnpmDescription
Impact
Under the default configuration, Mermaid state diagram's classDef allow DOM injection that escapes the SVG, although <script> tags are removed, preventing XSS.
Proof-of-concept
stateDiagram-v2
classDef xss fill:red</style></svg><style>*{x:x;y:y;overflow:visible!important;contain:none!important;transform:none!important;filter:none!important;clip-path:none!important}</style><div style="x:x;y:y;color:red;font:5em/1 monospace;display:grid;place-items:center;z-index:2147483647;width:100vw;height:100vh;position:fixed;top:0;left:0;background:black">HACKED</div><svg><style>a:b
[*] --> A:::xss
Patches
- v11.15.0 (see 37ff937f1da2e19f882fd1db01235db4d01f4056)
- v10.9.6 (see 4e2d512bf5bf6f9de1a8f0a48da78dc4d09ac4f3)
Workarounds
If you can not update to a patched version, setting "securityLevel": "sandbox" will prevent this, by rendering the mermaid diagram in a sandboxed <iframe>.
Credits
Thanks to @zsxsoft from @KeenSecurityLab for reporting this vulnerability.
Affected Packages
| Ecosystem | Package | Vulnerable range | Fix |
|---|---|---|---|
| 📦npm | mermaid | ≥ 11.0.0-alpha.1&&< 11.15.0 | 11.15.0npm install mermaid@11.15.0 |
| 📦npm | mermaid | all versions | 10.9.6npm install mermaid@10.9.6 |
Detection & mitigation playbook
Open-source dependencyDetect
Scan your dependency tree (package-lock.json, pnpm-lock.yaml, requirements.txt, go.sum, etc.) for mermaid, including transitive dependencies — a direct dependency you never call can still pull in a vulnerable version.
Fix
Update mermaid to 11.15.0 or later, then make sure no transitive (indirect) dependency still pins the vulnerable range — O3 confirms GHSA-ghcm-xqfw-q4vr is resolved across your whole dependency graph.
Workarounds
Stop feeding it untrusted input: reject or quarantine files and payloads from unverified sources until you can upgrade, restrict accepted formats to the ones you actually need, and run the parsing or decoding step in a least-privileged sandbox or short-lived worker so a crash or corrupted read cannot reach the rest of the process.
Fixing This On Your OS
If you run this on a Linux distribution, patch through your package manager against the distro's own security advisory below — it tracks the exact backported fix for your release, which can ship on a different timeline (and sometimes a different severity) than the upstream project.
This Moderate flaw in Mermaid, a JavaScript diagramming tool, allows for HTML injection through specially crafted state diagrams. While script execution is prevented, an attacker could manipulate the rendered content, potentially leading to altered visual presentation or information disclosure. This issue primarily…
To mitigate this vulnerability, configure applications utilizing Mermaid to render diagrams within a sandboxed iframe by setting the `securityLevel` option to `sandbox`. This prevents the HTML injection from escaping the SVG context and affecting the parent document. Consult the documentation for the specific application integrating Mermaid for instructions on how to apply this configuration.Source: Red Hat security advisory for GHSA-ghcm-xqfw-q4vr (CC BY 4.0)
Frequently Asked Questions
Is GHSA-ghcm-xqfw-q4vr in your dependencies?
Find it across npm, including transitive dependencies.