Reviewing & Staging Changes
The AI never touches your diagram directly. Every change it proposes goes through a preview → stage → commit flow so you can review, reposition, and confirm before anything lands on your board.
The Flow at a Glance
Preview in chat – A miniature preview appears inside the AI's response.
Stage on canvas – The proposed changes appear on your board with a dashed green highlight, which you can move.
Commit or discard – You apply the changes (merge or add) or throw them away.
Step 1: Preview in Chat
After the AI responds, the chat shows:
A miniature view of the proposed diagram changes.
A count of how many nodes and links are included.
Three action buttons: Cancel, Merge, and Add.
Click the expand icon to open a full-screen preview with a zoomable view. The full-screen preview has the same action buttons.
Step 2: Staging on Canvas
When you click Merge or Add, the proposed elements appear on your canvas inside a dashed green boundary. A floating action bar also appears with commit controls.
Merge
Apply the changes to your existing diagram. Existing elements are updated in place; new ones are added.
Add
Add every element as a new copy, without modifying any existing elements.
Discard
Remove the preview and discard the changes.
Repositioning Before Committing
While the staged area is visible, you can drag it around the canvas to reposition the proposed changes. Use this to place new elements exactly where you want them before committing.
Keyboard Shortcut
Press Escape at any time to discard the staged preview.
Step 3: Status Indicators in Chat
Each AI response shows its current status so you can always see what happened:
Previewing on canvas – The changes are currently staged for review.
Added to canvas – You applied the changes.
Preview discarded – You rejected the changes.
Preview replaced – A newer preview replaced this one.
Merge vs. Add — Which to Pick
Update the color, size, or labels of elements that already exist
Merge
Connect, rename, or reposition elements already on your board
Merge
Keep your existing diagram untouched and drop the AI's result next to it
Add
Compare the AI's version against what you already have
Add
Related
AI Chat – Sending messages that produce previews
@Mentions & Context – Tell the AI exactly what to change so Merge does the right thing
Last updated