Troubleshooting

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

Start with the symptom. Each page below works through the causes in the order they are most likely, and most of them are resolved in under a minute.

Two answers cover a surprising share of everything on this branch: reload the page once, and check the display mode.

#Start here

What you are seeing

Go to

Blank space where a diagram should be

Diagram does not render

The editor hangs or loads blank

Diagram editor will not open

Cut off, squashed, or scrolling oddly

Diagram is clipped or the wrong size

A language is not in the picker

A diagram language is missing

Work disappeared

Lost or unsaved diagram changes

Search cannot find it

Diagram missing from search

Gaps in a PDF

Diagrams missing from an export

An error message

Diagram error messages

#By symptom

Diagram does not renderA blank or broken diagram on a page: renderer errors, source size, a disabled language, or a missing preview.Diagram editor will not openThe editor hangs, loads blank, or reloads and loses work. Causes and the fastest checks for each surface.Diagram is clipped or the wrong sizeA diagram cut off, squashed or scrolling oddly, and which display mode and height settings fix it.A diagram language is missingA language absent from the picker is almost always an admin toggle. TikZ is off by default, ERD has no tile.Lost or unsaved diagram changesSaving is manual. Recover a draft snapshot, restore an earlier version, or resolve a save conflict.Diagram missing from searchNew diagrams and templates take a few minutes to index before they appear in search and the catalogue.Diagrams missing from an exportWhy a diagram is absent from a PDF, why Word export is unavailable, and why DMN cannot be exported.Diagram error messagesPaste the error you were shown and find what it means and what to do next, in one flat reference.Known issuesBehaviour we know about, what causes it, and what to do in the meantime.

Reload once. Then check the display mode.