Workflow Version History Guide
Every time you save a workflow, Ema creates a new version. The Version History panel lets you browse past versions, see exactly what changed between saves, preview any previous version on the canvas, and revert to a prior state when needed.
Opening Version History
From the workflow builder canvas, click the clock icon (Version History) in the toolbar. A drawer slides in from the right showing all saved versions, ordered from newest to oldest. The total version count is displayed in the drawer header.
Browsing Versions
Each entry in the version list shows:
| Detail | Description |
|---|---|
| Timestamp | When the version was saved, displayed in a friendly relative format (for example, "2 hours ago"). |
| Author | The email address of the builder who saved the version. |
| Version badge | A numbered badge such as v12. The current (latest) version is highlighted in green. |
| Revert indicator | If a version was created by reverting, it displays the source version number (for example, "reverted from v8"). |
Versions load incrementally as you scroll. When more versions are available, they are fetched automatically as you approach the bottom of the list.
Viewing Change Summaries
When you select a version or view the latest version, a Change Summary panel appears below the version entry. This panel compares the selected version against the immediately preceding version and shows a list of changes:
- Added items (green icon) -- New agents, connections, or configuration elements introduced in this version.
- Removed items (gray icon) -- Agents, connections, or configuration elements that were deleted.
- Modified items (amber icon) -- Agents or settings whose configuration changed (for example, updated instructions or renamed agents).
Each change is displayed as a compact pill showing the change type and a brief description. Hover over any change pill to see additional detail in a tooltip. If more than three changes exist, click See more to expand the full list.
Previewing a Past Version
Click a version entry to load that version on the canvas. Older versions open as a read-only preview so you can visually inspect the agents, connections, and layout, while the current version remains clickable so you can review its change summary and detailed changes.
To exit preview mode, click the close button in the top-right corner of the history previewer. The canvas returns to the live workflow state.
Reverting to a Previous Version
While previewing a past version, a Revert button appears in the version history panel. Clicking Revert restores the workflow to the state captured in that version. This creates a new version entry (so no history is lost) and the change summary for the new version will show "reverted from vN" to indicate its origin.
Reverting replaces the current workflow state with the selected version. Any unsaved changes to the current version will be discarded. Review the change summary and preview carefully before reverting.
Best Practices
- Save frequently -- Each save creates a checkpoint you can return to. Save before and after significant changes so you have clean rollback points.
- Preview before reverting -- Always preview a version on the canvas to confirm it is the state you want before clicking Revert.
- Use change summaries to audit -- When collaborating with other builders, use the change summary to understand what was modified in each version without opening every version individually.