Administration

Capable Diagrams works with no configuration at all, which is the point. Everything on this branch is optional, and most sites change two or three things: the language list, a space display mode, and possibly a shape library.

The one rule worth learning first is where each setting lives, because a setting changed at the wrong level appears to do nothing.

#The three levels

Level	Who can change it	Covers
Site	Confluence administrator	Languages, shape libraries, global templates, egress, renderer, AI
Space	Space administrator	Rendering defaults for every diagram in the space
Macro	Anyone who can edit the page	One diagram, overriding the space

Start with space settings. They fix the most common complaints, need only space admin, and are reversible without touching any page.

#Settings pages

Diagram settings overviewFind the global, space and macro settings for diagrams, and see which level wins when two disagree.Turn diagram languages on or offSwitch individual diagram languages on or off site wide, and see what a disabled language still does.Language presetsMinimal, Standard and Complete presets set the language list in one click. See what each preset keeps.Enable TikZTikZ ships disabled because it runs a full TeX engine. See how an admin turns it on and what changes.Global shape librariesUpload mxlibrary XML once so every editor on the site sees the same shapes. 3 MB per file, 3.5 MB served.Global template libraryWhere global diagram templates are stored, who can add them, and how they reach the insert picker.Space diagram settingsSet space defaults for rendering, dark mode, required titles, auto height, scrolling, scaling and display mode.Diagram permissionsA diagram inherits the permissions of the page or space that stores it. Control the shared asset space too.Restrict a diagramLock down a single diagram or template with restrictions instead of changing permissions for the whole library.Diagram indexingWhat indexing writes, why previews and templates take a few minutes, and how to run indexing.Egress domainsApprove your own domains so the browser loads diagram images and sources directly instead of via our proxy.Self-hosted diagram rendererPoint diagram rendering at your own Kroki compatible server. Requirements, the connection test, and the limits.Turn off AI featuresTurn off AI generation, chat and the Rovo agent from the Features tab in Capable global settings.

Security and privacy

The answers a security review asks for.

Reference

Macro fields, engines and limits.

Troubleshooting

When a setting is not doing what you expect.

Two settings and a shape library. That is usually all of it.