Administration

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

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

extension

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

extension
extension