Use Design Version History and Branches

Design saves ordered operations and periodic scene checkpoints. This keeps opening a file bounded without making one large JSON replacement the only record of collaboration. Name a Version before a review or handoff.

Restoring a Main Version creates a new current checkpoint. Versions created after the restored point remain in history. Branch Versions are named from the Branch and are not restored onto Main.

In the mobile app, open the Design file and choose Version history from its action menu. It lists saved Main versions, newest first. Editors can name the current version, and people who manage the file can restore an earlier one. Changes made since the last saved version are replaced by a restore, so name a version first if you may need them. If the Design changed after you opened the history, the app refuses the restore and reloads the list.

Create a Branch for a redesign or design-system change that must not affect Main. Open it from the Branch list. Its operations, comments, presence, and Versions remain separate. Update from Main incorporates changes to independent object properties. If Main and the Branch changed the same stable property, Magpie reports the conflict and leaves the Branch unchanged. Successful updates enter the Branch operation stream, so other open Branch tabs receive the same changes. A merged Branch remains available to inspect but is read-only.

Before merge, review the changed objects. Only an authorized team administrator can merge. Magpie creates checkpoints before and after the merge and marks the Branch as merged.

Offline operations remain in the browser and retry with the same operation ID after reconnect. When local operations are waiting, Recovery appears in the page bar. It can retry, download a JSON recovery file, or discard the local queue. Download the recovery file before discarding operations you may need.

The mobile app's Branches action lists active and merged Branches. Editors can create a Branch and update one from Main; people who manage the file can merge a Branch that is up to date with Main after confirming. If updating finds conflicting changes, the Branch is left as it was; resolve the conflicts in the Web editor. Branches are edited in the Web editor.

If a restore or Branch merge does not produce the Design you expected, download any Recovery file first, then Contact support.