Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>BPMN Visual Diff by Zoom On ITNew to Visual Studio Code? Get it now.
BPMN Visual Diff by Zoom On IT

BPMN Visual Diff by Zoom On IT

ZOOM ON IT

| (0) | Free
Visual diff tool for BPMN diagrams - GitLab MR & VS Code
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

BPMN Visual Diff

See what really changed in a BPMN process: added, removed and modified elements, numbered in process order and highlighted on the diagram, right inside VS Code.

Review view: changes listed in process order and pinned on the diagram

🎯 Features

  • 📊 Review View: Every change is numbered in process order, listed on the left and pinned on the diagram — stays readable with dozens of changes
  • 🔀 Four Views: Unified (removed elements overlaid on the new version), Before, After, Side by side
  • 🎨 Change Highlighting: Clear distinction between added, removed, and modified elements
  • 🔗 Git aware: Compare with HEAD or any previous revision, straight from the Explorer
  • ⚡ Fast Processing: Handles large BPMN files efficiently
  • 🎯 Element Tracking: Precise matching of BPMN elements across versions

📖 Usage

Basic Usage

  1. Open a BPMN file in VS Code
  2. Right-click on the file in Explorer
  3. Select "BPMN Diff: Open Diff Tool"
  4. Choose your comparison mode from the interactive menu

Explorer context menu with the BPMN Diff commands

Available Comparison Modes

  • Compare with HEAD: See changes in your working file vs git HEAD
  • Compare with Previous Version: Pick a specific git revision to compare against
  • Compare Two Files: Select any two BPMN files to compare them
  • Compare Active File with Selection: Compare your current editor with another file

Supported BPMN Elements

  • ✅ Process & SubProcess
  • ✅ Tasks (Service, User, Script, Manual, etc.)
  • ✅ Call Activities
  • ✅ Gateways (Exclusive, Parallel, Inclusive, Event-based)
  • ✅ Events (Start, End, Intermediate)
  • ✅ Flows (Sequence, Message)
  • ✅ Pools & Lanes
  • ✅ Data Objects & Artifacts

🚀 Capabilities

Change Detection

The extension automatically detects:

  • ADD: New elements in the updated diagram
  • REMOVE: Deleted elements from the original diagram
  • MODIFY: Changed attributes or positions
  • MOVE: Elements that changed location or parent

Visualization

Side by side view of the two versions

  • Color-coded changes (green=add, dashed red=remove, orange=modify, grey=move)
  • Click a change in the list or its numbered badge on the diagram to zoom to it
  • Filter by kind of change, search by name, id or condition
  • Word-level diff of changed names, conditions, scripts, delegates and fields
  • Keyboard navigation: J / N / ↓ next change, K / P / ↑ previous change
  • Reveal in XML opens the file (or the revision content) on the element's declaration; Copy id copies the element id
  • Follows the VS Code color theme and display language (English and French)

📋 Requirements

  • VS Code: Version 1.85 or higher
  • BPMN File: .bpmn or .xml file format

🐛 Troubleshooting

Extension not loading?

  1. Reload VS Code window (F1 → "Developer: Reload Window")
  2. Check if BPMN file extension is .bpmn
  3. Verify XML is valid

Can't see the diff?

  1. Ensure file is committed to git (for git-based comparisons)
  2. File must have changes compared to selected version
  3. File must be a valid BPMN XML diagram

Git not available?

  1. Ensure VS Code's git integration is enabled
  2. You can still use "Compare Two Files" without git

📄 License

Proprietary software, free to use. Copying, modification, reverse engineering and redistribution are not permitted. The full terms are in the LICENSE file shipped with the extension.

💬 Support

Questions and feedback: use the Q & A tab of this extension's Marketplace page, or write to contact@zoomonit.com. More on bpmn-diff.zoomonit.com.

Reviewing BPMN in GitLab merge requests? The Chrome extension shows the same visual diff right in the merge request and commit pages.

☕ Support the project

BPMN Visual Diff is free. If it saves you time, you can support me on PayPal. Thank you!

🎓 About BPMN

BPMN (Business Process Model and Notation) is a standard for modeling business processes. Learn more at bpmn.org


Created by: Zoom On IT
Version: 1.0.2
Last Updated: November 15, 2026

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft