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 overview
Find the global, space and macro settings for diagrams, and see which level wins when two disagree.
Turn diagram languages on or off
Switch individual diagram languages on or off site wide, and see what a disabled language still does.
Language presets
Minimal, Standard and Complete presets set the language list in one click. See what each preset keeps.
Enable TikZ
TikZ ships disabled because it runs a full TeX engine. See how an admin turns it on and what changes.
Global shape libraries
Upload mxlibrary XML once so every editor on the site sees the same shapes. 3 MB per file, 3.5 MB served.
Global template library
Where global diagram templates are stored, who can add them, and how they reach the insert picker.
Space diagram settings
Set space defaults for rendering, dark mode, required titles, auto height, scrolling, scaling and display mode.
Diagram permissions
A diagram inherits the permissions of the page or space that stores it. Control the shared asset space too.
Restrict a diagram
Lock down a single diagram or template with restrictions instead of changing permissions for the whole library.
Diagram indexing
What indexing writes, why previews and templates take a few minutes, and how to run indexing.
Egress domains
Approve your own domains so the browser loads diagram images and sources directly instead of via our proxy.
Self-hosted diagram renderer
The self-hosted diagram renderer setting has been removed. Use External diagram rendering to keep diagram source in Confluence.
Turn off AI features
Turn off AI diagram generation and AI chat for everyone with the AI integrations switch on the Features tab of Capable global settings.
External diagram rendering
External diagram rendering draws text diagrams on Capable's rendering service. It is on by default; turn it off to keep diagram source in the browser.
Related
Two settings and a shape library. That is usually all of it.