Troubleshooting

Website sign-in or document creation fails

Check your connection and any reported sign-in error. Website account operations and new-document creation require a connection. Complete any email verification requested during sign-up, or use the password recovery flow if necessary.

A diagram URL from a different account does not grant access. Confirm that you are signed into the account that owns the diagram.

Changes are not appearing in another session

1. Confirm that both sessions use the same account and diagram.
2. Inspect the sync indicator's tooltip or accessible label.
3. Restore connectivity or sign in again if the status requests it.
4. Use Retry synchronization when available.
5. Wait for All changes synced before checking the other session.

If the status is offline, changes remain on this device. Keep site data intact while recovering unsynchronized work. Do not clear browser storage as a first troubleshooting step.

TextGraph import fails

Use Import TextGraph with source text or a complete https://textgraph.dev/playground?d=... link. Check syntax in the playground. The website retains the input after an error so you can correct it and retry.

The import accepts up to 1 MiB of decoded source. When starting an import through URL parameters, supply exactly one source parameter. See the Quick Start for the normal dialog workflow.

The canvas does not open

Use a current browser with WebAssembly support. Inspect the displayed error, then retry opening the editor. Check whether extensions or network policies are blocking the site's scripts, WebAssembly, or canvas resources.

If the editor reports that its session has closed, use its Reload page action. Preserve site data when reloading so locally saved changes remain available.

A large diagram is difficult to work with

Close unneeded browser tabs, simplify decorative content, and divide a large subject into focused diagrams. Keep readable labels and link related documentation rather than placing every detail in one drawing.

A Confluence preview is missing

Confirm that the app is installed and that you can edit the page. Open the existing macro and choose Publish to regenerate its saved preview. If publication reports an error, keep the editor open while resolving it.

The editable document and preview each have a 240 KiB serialized-value limit. The host can reduce the preview; an oversized editable document must be simplified. See Confluence.

A Confluence change was not saved

Use Publish to save the diagram. Discard & close does not publish changes. Edit the existing macro when updating a diagram; inserting a replacement macro does not transfer the old macro's saved document.

A .draw.png opens as an image in VS Code

Verify that the DrawMotive extension is installed and enabled. Use Open With… to select the DrawMotive editor. For a new diagram, run DrawMotive: New Diagram rather than creating an empty PNG file.

VS Code changes are missing from the file

Choose Save diagram and check for reported save errors before closing the tab. If another tool changed the file, review the reload prompt carefully: reloading can discard unsaved canvas changes.

If the webview fails to load, update VS Code and inspect the Developer Tools console for errors. The extension requires VS Code 1.95 or newer. See the extension issue tracker when reporting a reproducible problem.

A shared PNG no longer reopens as an editable diagram

An ordinary PNG does not contain a DrawMotive document. Image processing can also remove the embedded data from a .draw.png. Keep the original editable file and avoid overwriting it with an image-only copy.