How to Migrate from Stratus "Mermaid Diagrams" — Before It Stops Working

If your Confluence site uses Mermaid Diagrams for Confluence by Stratus Add-ons, you've probably noticed the warnings: Atlassian is ending support for Connect-era apps (end of support: January 31, 2027), admins now see in-product banners flagging legacy apps, and the Stratus app itself hasn't shipped an update since September 2025.

Nothing dramatic happens on deprecation day — but a frozen app on an unsupported platform degrades quietly: rendering bugs go unfixed (recent reviews already report them), new Mermaid syntax never arrives, and one day a Confluence change breaks something nobody will repair.

Where your diagrams actually live (good news)

The Stratus app stores each diagram's Mermaid source as a text attachment on the page (named per the macro's filename parameter), alongside a cached PNG. Your source code is yours, in your site, even though the app is frozen. No vendor server holds your data hostage.

Option 1 — Automatic (one click)

Install Mermaid Diagrams Pro (free ≤10 users).
Go to Apps → Migrate to Mermaid Pro.
Click Scan site for Stratus diagrams — the tool finds every legacy macro, reads each diagram's source from its attachment, and shows a preview table.
Review, select, click Convert selected.

Each affected page gets a new version with the diagram converted — source now stored in the page itself. Original page versions are preserved in history, so any page can be reverted. The Stratus attachments are left untouched; once you've verified everything renders, uninstall the legacy app.

Everything happens between your browser and Atlassian's APIs — no diagram ever leaves your site.

Option 2 — Manual (if you only have a few)

On each page, open the attachments and download the text file — that's your Mermaid source.
Insert a Mermaid Diagram (Pro) macro (/mermaid).
Paste the source, Save. Delete the old macro.

Tedious beyond ~10 diagrams — which is why we built Option 1.

After migrating, you also get

Dark-mode aware rendering — diagrams follow each reader's theme
Zoom & fullscreen on every diagram, plus SVG/PNG export
Live-preview editor with starter templates
Current mermaid.js — new diagram types as the language evolves
Runs on Atlassian — zero egress, data-residency friendly

FAQ

Will my page history survive? Yes — conversion creates a normal new page version; everything before it is intact.

What if a diagram fails to convert? The tool marks it and moves on; nothing on that page is changed.

Do I need to be an admin? Site admin is recommended — the tool operates with your permissions.

Can I test on one page first? Yes — scan, then convert only that page's diagrams.

Install Mermaid Diagrams Pro →