Version History & Restore
Overview
Version History automatically saves every change you make to your workflows. You can view your complete workflow evolution, compare different versions, and restore previous states with one click.
📹 Video Tutorial: Watch how to use Version History
Accessing Version History
- Open a workflow in the editor
- Click the Version History icon in the toolbar (clock icon)
- The version panel opens on the right side
Understanding the Version List
Each version entry shows:
- Version number - Sequential number (1, 2, 3...)
- Date & time - When this version was created
- Star icon - Mark favorite/important versions
- View Runs button (▶️) - See all executions of this version
- Actions - Restore, compare, or delete buttons
Version States
- Latest - Your current workflow state (cannot be deleted)
- Starred - Important versions you've marked (protected from auto-cleanup)
- Regular - Standard versions (may be auto-cleaned after 50+ versions)
Viewing Workflow Execution Runs
What Are Workflow Runs?
Every time a workflow executes (via schedule, manual trigger, or API), it creates a run record showing:
- Execution status (completed, failed, running)
- Start and completion times
- Duration
- Steps completed
- Error messages (if failed)
- Which version was executed
Viewing Runs for a Version
- Find the version you want to check
- Click the View Runs button (▶️ icon)
- A modal opens showing all executions of that version
The runs table displays:
- Status - Visual indicator (✓ completed, ✗ failed, ⏱ running)
- Started - When execution began
- Completed - When execution finished
- Duration - Total execution time
- Steps - Number of steps completed
- Error - Error message if execution failed
Why View Runs?
- Debug Issues: See which versions had execution problems
- Performance Tracking: Compare execution times across versions
- Version Validation: Verify the correct version is running
- Historical Analysis: Track execution patterns over time
Viewing & Comparing Versions
Quick Compare with Previous
- Find the version you want to check
- Click the Compare button next to it
- See changes from the previous version
Compare Any Two Versions
- Click Compare Mode button at the top
- Select first version (checkbox appears)
- Select second version
- Click Compare Selected
- View detailed differences
Understanding the Diff View
The comparison shows:
🟢 Added Workers (green)
- New workers that were added
- Their complete configuration
🔴 Removed Workers (red)
- Workers that were deleted
- What was removed
🟠 Modified Workers (orange)
- Workers that changed
- Side-by-side parameter comparison
- Only shows changed parameters
Summary Statistics
- Total workers: added/removed/modified
- Connection changes count
Restoring Previous Versions
How to Restore
- Find the version you want to restore
- Click Restore button
- Confirm the action
- Workflow reverts to that state immediately
What Happens When Restoring
- Your current state is saved as a new version first
- The selected version's configuration is applied
- A new version is created (nothing is lost)
- You can undo the restore by restoring the newer version
Safety Features
- Current work is always preserved in a new version
- You can't accidentally lose your current state
- All restores are reversible
Managing Versions
Starring Important Versions
Why Star Versions?
- Mark stable/production versions
- Highlight important milestones
- Protect from auto-cleanup
- Filter to show only key versions
How to Star:
- Click the star icon next to a version
- The star fills in (version is now protected)
- Click again to unstar
Deleting Versions
When to Delete:
- Experimental versions you don't need
- Clean up messy development history
- Keep version list focused
How to Delete:
- Click the trash icon next to a version
- Confirm deletion
- Version is permanently removed
Restrictions:
- Cannot delete the latest version
- Deleted versions cannot be recovered
- Use carefully!
Creating Manual Snapshots
When to Create Snapshots:
- Before major changes
- Before experimentation
- At project milestones
How to Create:
- Click Create Snapshot button at the top
- Current state is saved immediately
- Tagged as "snapshot" in version list
Practical Workflows
Safe Experimentation
Before trying risky changes:
- Your current work is already saved (latest version)
- Make experimental changes
- Test the results
- If it doesn't work: Restore the previous version
- If it works: Continue with new version
Finding What Broke
When something stops working:
- Open version history
- Find last known working version
- Compare it with current version
- Review what changed in the diff
- Either fix the change or restore
Tracking Progress
During development:
- Save regularly as you work (auto-versioned)
- Star versions at milestones
- Review starred versions to see progress
- Delete experimental versions to clean up
Team Collaboration
When working with others:
- Open version history after teammate saves
- Compare their version with previous
- See exactly what they changed
- Continue work with full context
Version Limits & Cleanup
Automatic Limits
- Maximum 50 versions per workflow (default)
- Oldest unstarred versions are auto-removed
- Starred versions are kept indefinitely
- Latest version is always protected
Manual Cleanup
- Delete unnecessary versions anytime
- Keep only meaningful milestones
- Reduces clutter in history
- Makes important versions easier to find
Tips & Best Practices
1. Star Strategically
Mark versions with meaningful context:
- "working-production-config"
- "before-major-refactor"
- "client-approved-version"
- "stable-before-api-change"
2. Compare Before Restoring
- Always compare first to see what will change
- Verify you're selecting the right version
- Understand what you'll lose/gain
3. Use Quick Compare for Recent Changes
- "Compare with Previous" shows last change
- Perfect for "what did I just change?"
- Fast iteration feedback
4. Create Snapshots Before Big Changes
- Manual safety checkpoint
- Easy to find in history
- Clear "before/after" marker
5. Clean Up Regularly
- Delete old experimental versions
- Keep only meaningful history
- Easier to navigate
Common Questions
Q: When are versions created?
A: Automatically every time you save the workflow (manual save or auto-save).
Q: Can I disable auto-versioning?
A: No, it's always active to protect your work. Delete unwanted versions manually.
Q: What if I restore the wrong version?
A: Your previous state was saved as a new version. Just restore that newer version.
Q: How do I find a specific version?
A: Use the date/time stamps and star important versions for quick access.
Q: Can I rename versions?
A: Not currently. Use the star feature to mark important ones.
Q: Do versions slow down my workflow?
A: No, versioning has zero impact on workflow execution speed.
Q: What's saved in a version?
A: Complete workflow configuration: all workers, connections, parameters, and layout.
Q: Can I export version history?
A: Not yet - this feature is planned for future updates.
Troubleshooting
Version History Not Showing
- Ensure you're in the workflow editor (not dashboard)
- Click the version history icon in toolbar
- All workflows have version history enabled
Can't Delete a Version
- Latest version cannot be deleted (safety feature)
- Make sure you're not trying to delete the current version
Restore Not Working
- Verify you have edit permissions for the workflow
- Check that you've confirmed the restore action
- Try refreshing the editor
Compare Shows No Changes
- Verify you selected two different versions
- Some versions might be identical if saved without changes
Next Steps
- Read about Creating & Editing Workflows
- Learn about Managing Workflows
- Explore the Workers section to learn about individual workflow components
Remember: Version history is your safety net. Save often, star important versions, and experiment fearlessly knowing you can always go back!