Confluence Integration
The DrawMotive Confluence Cloud macro displays a saved PNG preview on a page. Opening the macro editor loads an editable canvas. The host provides Publish and Discard & close actions.
Before you start
The app must be installed on your Confluence Cloud site. Ask your site administrator whether the DrawMotive macro is available and confirm that you have permission to edit the page. This integration targets Confluence Cloud.
Create a diagram
- Open a Confluence page in edit mode.
- Insert the DrawMotive macro using the macro browser.
- Create and label your diagram in the macro editor.
- Choose Publish to save the diagram and update its preview.
- Publish the Confluence page as usual.
Canvas controls
The macro host shows keyboard tools above the canvas. Focus the canvas, then use:
| Key | Tool |
|---|---|
| V | Select |
| R | Rectangle |
| A | Arrow |
| O | Ellipse |
| D | Diamond |
| T | Text |
| Escape | Cancel the current interaction |
The host's controls differ from the website toolbar.
Edit an existing diagram
Open the page in edit mode, select the existing macro, and use Confluence's macro edit action. Make your changes and choose Publish. The saved preview updates after publication.
Choose Discard & close to close without publishing your changes; the host asks for confirmation.
Saved data and size limits
The host stores the editable document and PNG preview separately in Forge storage. Each serialized value must fit within 240 KiB, including JSON encoding.
The preview can be reduced to fit its limit. An oversized editable document is rejected rather than split into multiple storage values. If publication fails, the editor reports the error and keeps the diagram open so you can reduce its size and retry.
Keep the existing macro when updating a diagram. Creating a new macro gives it a separate identity rather than transferring the previous macro's saved data.
Collaboration
The viewer displays the published preview. The macro editor does not provide simultaneous multi-user editing or the diagrams website's account synchronization. Coordinate editing and publication with other page editors.
For a walkthrough, see Project Roadmap in Confluence.