Skip to main content
A comparison puts two or more files next to each other on the canvas, so you can pick between options or see what a change did. The files can come from the same branch or from different branches.

​
Ask for several options

Ask the agent for options as separate files, then compare them:
Each option becomes its own page with its own canvas node. Then make a comparison from any two or three of them.

​
Make a comparison

  1. Click Compare above a node. Or open the file list and click the plus next to Comparisons (New comparison).
  2. The dialog lists your branches under Branches. Your default branch and the branch you are on start ticked.
  3. For each ticked branch, open its file picker and choose one or more files. Two files on one branch are enough.
  4. Click Compare.
The comparison appears on the canvas next to the node you started from, or in the middle of the screen if you started from the file list. The Compare button stays grey until you have picked at least two files. A branch nobody has opened yet can’t be ticked: open it once, then come back.

​
Look at it three ways

The first buttons in the comparison’s toolbar switch how the files are shown: Overlay and Swipe work with exactly two files. A comparison of three or more uses Side by side.

​
Use the previews

A comparison shows the live screens, but they ignore clicks until you unlock it. Double-click it, or click Enable interaction in its toolbar, to click through the screens. Click Open focus view to see it full size.

​
Keep it up to date

Each preview stays exactly as the file looked when you made the comparison. Its label says Pinned and how long ago, for example “Pinned 2h ago”. That way a comparison still shows what you compared, even after the files change.
  • When a file has changed since, an amber dot appears on its label and on the update button.
  • Click the update button (Update every preview to its branch’s latest build) to bring every preview up to date.
  • If a branch is deleted, its preview keeps its last state and its label is tagged Deleted.

​
Change or remove it

  • Change what’s compared opens the same dialog with the current files picked. Add or remove files, then click Save. Files you keep stay as they were; files you add show their current state.
  • Remove comparison deletes the comparison. The files themselves stay.
Every comparison is also listed under Comparisons in the file list. Click one there to jump to it. You can only make or change comparisons on the latest version. On an older version, Compare and New comparison are greyed out and say Go back to the latest version to compare.