Workflow Versioning
Publish snapshots, restore historical versions, and handle legacy definitions
Publishing a workflow automatically saves a version snapshot. A version contains the definition, variables, trigger configuration, and creation information.
Publishing a Version
- Save the draft and open the Checklist.
- Fix all errors; evaluate warnings before publishing.
- Select Publish and set the run page presentation to Form and Results or Results and Details.
- After publishing, the version number increments and the run entry uses the currently published version.

Viewing and Restoring
View snapshots in Workflow Settings > Version History. Select a version and click Restore; the system first saves the current state, then creates a new current version from the restored one. Restoring does not delete other history records.
Legacy Workflows
Legacy definitions with schema_version less than 2 can be loaded onto the canvas, but the run button is disabled. Re-saving writes the new type system version; this is a hard switch, and legacy definitions are not migrated automatically at runtime.
Record version notes before publishing, and after restoring re-run the input boundary, conditional branches, sub-workflows, and external side-effect nodes.
How is this guide?