Moving off Mermaid for Confluence, Swagger UI for Confluence or PowerPlantUML
These three Confluence Cloud apps still run on Atlassian Connect and have had no update since Atlassian froze Connect updates. Atlassian ends Connect support on January 31, 2027. Specdock is built on Forge and covers all three: Mermaid diagrams, Swagger/OpenAPI docs and PlantUML diagrams, on any page.
Which apps are affected
| App | Installs | Last update | Replace with |
|---|---|---|---|
| Mermaid for Confluence (Tech Labs) | about 800 | December 2024 | Specdock's Mermaid diagram macro |
| Swagger UI for Confluence (Tech Labs) | about 650 | April 2025 | Specdock's OpenAPI / Swagger docs macro |
| PowerPlantUML | about 430 | May 2022 | Specdock's PlantUML diagram macro |
Source: Atlassian Marketplace, checked November 14, 2026.
How to move, in four steps
- A Confluence admin installs Specdock from the Atlassian Marketplace (free for up to 10 users).
- Open Settings → Specdock settings and run the migration scanner on a space. It lists every page that still uses an old Swagger/OpenAPI, Mermaid or PlantUML macro, with its spec or diagram text.
- On each page, type / and add Specdock's Mermaid diagram, PlantUML diagram or OpenAPI / Swagger docs macro, then paste the text (or point it at the same attachment, Git file or URL).
- Check the page, remove the old macro, publish. When no pages are left, uninstall the old app.
What you get on Forge
- Runs on Atlassian: no outside server stores your pages.
- Specs from attachments, GitHub, GitLab or Bitbucket Cloud (private repos too), so docs don't go stale.
- OpenAPI 3.x, Swagger 2.0 and AsyncAPI, plus a breaking-change report between two versions.
Questions
Will my Mermaid, Swagger or PlantUML pages break on January 31, 2027?
Atlassian ends support for Connect apps on January 31, 2027. Apps that are still on Connect after that date are not supported and can stop working. If your app has not moved to Forge, plan to replace its macros before then.
How do I find the pages that use the old app?
Install Specdock, open Settings → Specdock settings and run the migration scanner for a space. It lists the pages that still use an older Swagger/OpenAPI, Mermaid or PlantUML macro, with the spec or diagram text each one uses.
Do I have to rewrite my diagrams?
No. Mermaid and PlantUML text works as it is: copy the text the scanner shows into Specdock's Mermaid or PlantUML macro. For Swagger/OpenAPI, point the macro at the same attachment, Git file or URL.
Is my old app still on Connect?
Check it on the free lookup in our Connect end of support guide. It reads the app's latest version from the Atlassian Marketplace and tells you whether it is on Forge, migrating, or at risk.
What does Specdock cost?
Free for up to 10 users. Above that it is billed per user per month through Atlassian.
Not sure which of your apps are on Connect? Use the free lookup in the Connect end of support guide. More about Specdock: documentation.