# Troubleshooting

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.](https://help.gocapable.com/diagrams/diagram-does-not-render.html)[Diagram editor will not openThe editor hangs, loads blank, or reloads and loses work. Causes and the fastest checks for each surface.](https://help.gocapable.com/diagrams/diagram-editor-will-not-open.html)[Diagram is clipped or the wrong sizeA diagram cut off, squashed or scrolling oddly, and which display mode and height settings fix it.](https://help.gocapable.com/diagrams/diagram-is-clipped-or-the-wrong-size.html)[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.](https://help.gocapable.com/diagrams/a-diagram-language-is-missing.html)[Lost or unsaved diagram changesSaving is manual. Recover a draft snapshot, restore an earlier version, or resolve a save conflict.](https://help.gocapable.com/diagrams/lost-or-unsaved-diagram-changes.html)[Diagram missing from searchNew diagrams and templates take a few minutes to index before they appear in search and the catalogue.](https://help.gocapable.com/diagrams/diagram-missing-from-search.html)[Diagrams missing from an exportWhy a diagram is absent from a PDF, why Word export is unavailable, and why DMN cannot be exported.](https://help.gocapable.com/diagrams/diagrams-missing-from-an-export.html)[Diagram error messagesPaste the error you were shown and find what it means and what to do next, in one flat reference.](https://help.gocapable.com/diagrams/diagram-error-messages.html)[Known issuesBehaviour we know about, what causes it, and what to do in the meantime.](https://help.gocapable.com/diagrams/known-issues.html)

---

## Related

[AdministrationSettings behind several of these symptoms.](https://help.gocapable.com/diagrams/administration.html)

[ReferenceLimits, engines and macro fields.](https://help.gocapable.com/diagrams/reference.html)

[Security and privacyWhat anonymous readers see.](https://help.gocapable.com/diagrams/security-and-privacy.html)

---

_Reload once. Then check the display mode._