Overview
When a workflow breaks in production, you can roll it back to any previous version instantly — without contacting support or touching code. Restore Version publishes a past version of your workflow immediately, replacing the current live version. In this article, we'll cover how to find and restore a previous workflow version, and what to expect when you do.
Understand how version restore works
Every time a workflow is saved, gaiia creates a new version and adds it to the workflow's version history. When you restore a past version, gaiia doesn't overwrite your history — it creates a new version sourced from the one you selected, keeping your full change history intact and traceable.
For example, if version 59 is failing and version 58 was stable, restoring version 58 creates a new version 60 sourced from 58. Your version history will reflect this accurately.
Important: Restoring a version publishes it to production immediately. The current live version is replaced the moment you confirm. There is no draft or preview step between restoring and going live. Any ongoing workflows will continue to use the version it started on.
Restore a previous workflow version
- Navigate to the workflow you want to restore.
- Open Version History in the sidebar of the Workflow view.
- Review the list of versions to identify a version to restore. You can click into a version to inspect its workflow definition and execution history before committing.
When you've identified the version you want on the Version History tab, click Restore Version in the three-dot menu to the right of the version’s row.
A confirmation modal will appear:
Restore version? This action will create and publish a new version of the workflow using the selected version. The current live version will be immediately replaced.
Click Restore Version to confirm.- gaiia will create and publish a new version immediately. In Version History, you'll be taken to the new version, confirming the restore was applied correctly.
Understand availability and permissions
- Any user with Workflows Edit permissions can restore a version
- No additional roles or configuration are required
- The Restore Version button is only visible on past versions — it does not appear on the current live version
Note: If you don't see the Restore Version button, check that your role has Workflow Edit permissions. Contact your administrator if you need access.