Skip to content

BPMN Modeler FAQ

This page collects answers to common questions raised in the BPMN.iO support issue queue. Each entry links back to the original discussion for full context.


How do I upgrade from BPMN.iO 2.x to 3.x?

BPMN.iO 3.x depends on ECA 3.x. Upgrading the modeler without upgrading ECA will cause a fatal error:

1
"bpmn_io.prepare_components" has a dependency on a non-existent service "modeler_api.service"

Always upgrade ECA and BPMN.iO together and follow the ECA 3.0.0 release notes upgrade procedure. ECA 3 includes update scripts that enable the required new modules.

Original discussion (d.o #3571323)


The status message overlaps the modeler UI in Claro

When using the Claro admin theme, the "Model saved" status message may appear in the centre of the screen, cannot be dismissed, and never disappears. This is caused by a CSS selector mismatch: the bpmn_io JavaScript that makes messages dismissible uses a selector that does not match Claro's message markup.

Solution: Switch to the Gin admin theme, where message handling is already optimised. Claro is being deprecated in Drupal core in favour of Gin.

Original discussion (d.o #3544342)