Documentation Guides
Troubleshooting
Fix editor loading, origin, autosave and HTML export errors.
On this page
The editor is blank
- Set a container height and mount after the element exists.
- Supply a valid editor key and userId. Check the console and blocked network requests.
- Catch synchronous mount errors, onError and ready rejections.
Origin or CSP blocks loading
Allow the application’s exact origin in dashboard settings, including scheme and port. Add the following destinations to your existing Content Security Policy; this is only a fragment, not a complete policy.
frame-src https://weavour.com;
connect-src 'self' https://api.weavour.com;
script-src 'self' https://weavour.com;Methods fail before readiness
Await editor.ready or enable actions in onReady. In React, wait before calling the ref. The compatibility /editor.js alias uses earlier readiness timing; use the npm SDK or versioned browser script for this workflow.
For incompatible_editor, check SDK and hosted editor compatibility. Do not remove document fields or downgrade schemaVersion to bypass the error.
Saving fails or conflicts
Keep unsaved work open. For autosave_disabled, check dashboard and SDK preferences. For conflicts, use the editor’s recovery flow. A timeout can occur after a write succeeds.
If content becomes read-only, check the workspace subscription and the editor mode. Export remains available when a subscription expires.
Content is in the wrong scope
Check the workspace selected by the editor key and the supplied IDs. Organization workflows need both userId and organizationId. Save and remount to switch identity; in React, change key.
Export fails or the received email differs
Wait for media preparation, handle exportHTML() errors and check personalization issues. Send the export, not previewHtml. Test final emails in the clients your audience uses; rendering, image caching and animation support vary.
For support, include SDK version, browser, application origin, error code and reproduction steps. Remove credentials and recipient data.