External diagram rendering
Most diagram types can be drawn in the reader's browser. A few, such as D2, TikZ and Structurizr, need a rendering service. External diagram rendering decides whether Capable's service is used.
It is on by default, so every diagram type works. Turn it off if diagram source must never leave Confluence.
#Where it is
In Capable Diagrams and Capable for Confluence, open Global settings, then Diagrams, then the General tab. The card is External diagram rendering: "Draw text diagrams on Capable's rendering service. On by default. Turn off to draw in the reader's browser instead; types the browser cannot draw stay unavailable."
In the standalone Markdown and Formatting apps, the same switch is on the Diagram rendering tab, as Use enhanced diagram rendering.
#What changes when it is off
Diagram types | |
|---|---|
Drawn without it | Mermaid, draw.io, PlantUML, C4-PlantUML, BPMN, DMN, Excalidraw, Graphviz, DBML, Vega and Vega-Lite. PlantUML that includes files from outside the standard library still needs the service. |
Need it | actdiag, blockdiag, bytefield, D2, Ditaa, Erd, Nomnoml, nwdiag, packetdiag, Pikchr, rackdiag, seqdiag, Structurizr, Svgbob, Symbolator, TikZ, UMLet, WaveDrom and WireViz. |
Types that need the service are no longer offered when creating a diagram. Existing ones show their last saved image, or a notice if there is none. See A diagram says Needs enhanced diagram rendering.
#Where the service runs
In the United States for every site, including sites hosted in the EU. Diagram source is sent, the image comes back, and nothing is stored. See Data residency in Trust and Notices.
Capable Diagrams (Zero Egress) never sends diagram source anywhere, so it has no External diagram rendering switch. Its General tab has Shared page rendering instead, which draws all the diagrams on a page with one shared worker.
#A few things worth knowing
Changing the switch takes effect when open pages are reloaded. The app says so when you change it.
The Zero Egress library preset is only offered while external rendering is off.
Turning it off does not delete any diagram. Turn it back on and every type draws live again.
#Related
On by default. Yours to turn off.
