Eriksen Labs Support
Documentation

Questions and answers

v2.10.0Updated

On this page
  1. Do I need to know how to code?
  2. How do I change a diagram after publishing?
  3. Can it show our OpenAPI or Swagger file?
  4. I can't find Mermaid Diagram.
  5. Who can change my diagram?
  6. Why is Save grayed out?
  7. Save did not close the editor.
  8. The diagram is tiny, or too wide.
  9. My flowchart became one long row.
  10. Why does it look different in dark mode?
  11. Why does Word show code instead of my diagram?
  12. Why does the notification email show code?
  13. My PDF export is slow, or it fails.
  14. Can I put a diagram in slides or a chat?
  15. Can I move diagrams from another Mermaid app?
  16. Can an AI write it?
  17. Where does Full documentation go?
  18. What is the line at the top of the editor?
  19. Does the app send my diagrams anywhere?
  20. Does it work on Confluence Data Center?
  21. Which browsers does it work in?
  22. What happens to our diagrams if the license lapses?
  23. Still stuck?

Do I need to know how to code?

No. Pick an example and change the words, copy a recipe, or let Draft with AI write a first draft.

How do I change a diagram after publishing?

Edit the page, select the diagram, and select Edit. Clicking inside the diagram does not select it; see Change a diagram later. You can't edit it from the published page.

Can it show our OpenAPI or Swagger file?

Yes, since 2.11.0. Type /openapi and paste the description, YAML or JSON. The page shows a map of its endpoints and schemas, with the details under it. Nothing is fetched or called. See OpenAPI in Confluence.

I can't find Mermaid Diagram.

Edit the page and type /mermaid on an empty line. If it isn't in the list, the app is not installed. Ask a Confluence admin.

Who can change my diagram?

Anyone who can edit the page. Readers can view, zoom, copy and download it. Confluence's page permissions decide who can do which.

Why is Save grayed out?

The diagram has an error. Selecting Save brings it into view, and Fix with AI under it copies a prompt to fix it. See Fix an error.

Save did not close the editor.

Read the line under the diagram source. If the diagram has an error, fix it; Fix with AI can help. If a note above Save says "Not saved yet: no picture for Word and PDF", select Save without picture to save it anyway, or make the diagram smaller. If the line says "Still loading the diagram…", wait a moment and select Save again.

The diagram is tiny, or too wide.

Use Fit, zoom or the full-screen button. For a long process, use flowchart TD so the diagram grows down, not across.

My flowchart became one long row.

Its groups set their own direction, and since version 2.9 that is followed only while no arrow joins a box inside a group to a box outside it. Open the diagram: a note under the text says what to write for each arrow. See My flowchart became one long row on the support page.

Why does it look different in dark mode?

Its colors are set to Auto, which follows Confluence's light or dark mode. To keep it the same for everyone, choose one of the other Colours.

Why does Word show code instead of my diagram?

The diagram was saved before version 2.4, or it sets its own theme or colors and was saved before 2.6. Open it and save it once to add its picture. A diagram too large or too tall for a picture also shows as code. See Export the page to PDF or Word.

Why does the notification email show code?

Emails always show a diagram's text as code. Many email programs do not show pictures sent this way.

My PDF export is slow, or it fails.

The page probably has diagrams saved before version 2.4, or diagrams that set their own theme or colors and were saved before 2.6. Open and save each one, then export again. Pages with about 100 or more diagrams can also hit a limit; see Current limitations.

Can I put a diagram in slides or a chat?

Yes. Select Image in its toolbar and paste it, or download a PNG.

Can I move diagrams from another Mermaid app?

Yes, by copying and pasting. See Moving a diagram from another Mermaid app.

Can an AI write it?

Yes, a first draft for you to check. Open Draft with AI above the diagram source, describe the diagram, and paste the prompt into the AI chat you use. See Draft with AI.

Where does Full documentation go?

To this guide, on eriksenlabs.com. Mermaid's own reference, written for developers, is at mermaid.js.org.

What is the line at the top of the editor?

Either a note that your site is evaluating the paid tier, or a request for a rating of the app on the Atlassian Marketplace. Neither stops you editing or saving. See The evaluation note and the rating line. A line saying that editing needs an active license is different: the site's license is not active, and the editor does not save until it is.

Two links in the editor open a page outside Confluence, and only when someone selects them. Full documentation opens this guide on eriksenlabs.com. This website counts page views with Cloudflare Web Analytics, without cookies; see This website in the privacy policy. Rate it, on the rating line, opens the app's reviews on the Atlassian Marketplace.

Does the app send my diagrams anywhere?

The app requests no permission scopes and sends nothing outside Atlassian. Diagrams live in the page and are drawn in your browser. Page exports, page history and notification emails use the app's own function on Atlassian's platform, which keeps nothing. Draft with AI and Fix with AI only copy a prompt to your clipboard. You paste it into an AI chat yourself.

More in For Confluence admins.

Does it work on Confluence Data Center?

No. It works on Confluence Cloud only.

Which browsers does it work in?

Current versions of Chrome, Edge and Firefox, and Safari 17.4 or later. That is what Mermaid 12, which the app draws with since version 2.9, supports. On an older browser, some kinds of diagram are not drawn: a use case diagram shows "Could not render this diagram".

What happens to our diagrams if the license lapses?

They keep showing on their pages as they were last saved, with the toolbar, and exports keep their pictures. Only editing stops: the editor opens, says that editing needs an active license, and does not save. A Confluence admin can subscribe; see For Confluence admins. Before version 2.8, pages showed "A licence is needed to show this diagram" in place of each diagram.

Still stuck?

Raise a request in our support portal, or email [email protected]. First reply in 1-3 business days, depending on severity (see our service level agreement).

These help us answer faster:

  • The diagram's text (select Copy in its toolbar)
  • What you expected, and what happened instead
  • A screenshot, if it is a visual problem