Technical

Understanding Workflow Versions

Last updated 29 May 2026

Understanding Workflow Versions

Every time you publish a workflow, BizFlow saves a new version of the canvas. This means you can keep improving a workflow without disrupting instances that are already running.

How versioning works

  • Every publish creates a numbered version (v1, v2, v3, ...)
  • Existing running instances always complete using the version they were started on
  • New instances triggered after a publish use the latest published version
  • You can edit a draft freely without affecting live instances — the draft is saved automatically but does not create a new version until you publish

Viewing version history

  1. Open a flow in edit mode
  2. In the right-hand sidebar, open the Versions panel
  3. You will see a list of all versions with their publish date
  4. Click any version to preview the canvas at that point in time (read-only)

Comparing two versions

  1. In the Versions panel, click Compare versions
  2. Select two version numbers (defaults to newest vs previous)
  3. Click View changes — a summary dialog shows:
    • Steps added or removed
    • Steps that were renamed, had fields added/removed, or had their assignee rule changed
    • Connections (edges) added or removed

Draft vs published

  • Draft: your current working copy; saved automatically as you edit. Does not affect live instances.
  • Published: the version that new flow triggers will use. Each publish increments the version number.

Notes

  • Unpublishing a workflow prevents new instances from being triggered but does not cancel instances already running
  • Version numbers are internal — users triggering a flow always get the latest published version automatically