News from the project

Camunda BPMN Properties Feature Complete

Published by Patrick Dehn on Friday, 04 March 2016.


With the latest version of our properties panel we provide editing support for all Camunda execution related properties. We added input/output variable mappings, form fields, connectors, compensation activity references and camunda:properties for form fields and extension elements. Besides that we carried out some significant usability improvements and fixed tons of bugs. We took big steps to further improve the internal code quality so that contributions should be easier, too.

What's new

Let's take a look at the new features and how to use them.

Input/Output Mappings

One of the most important feature is the support for input/output mappings. If you start adding parameters, the properties panel automatically adds the Camunda extension element inputOutput to the element. It can contain multiple inputParameter and outputParameter elements of different types. Besides the text, script and list type you can configure complex input/output parameter mappings using the type map.

Learn more about using input/output variable mappings with Camunda.

Form Fields

The second major feature is the configuration of form field properties. Both types form key and form data are supported. Choose the Form Data type to configure complex form fields which allows fine grained control over ids, types, label and default values for each field. If you select the enum type, you can furthermore add, edit and remove camunda:value properties. It is also possible to configure properties of the type camunda:properties.

Learn more about generated task forms and using form fields with Camunda.

Scrollable Tabs

Supporting more and more properties to the panel is great but it also makes it harder for users to find what they are looking for. In the last release we introduced tabs to improve discoverability. With this release we greatly improved the tabbing usability. You can now switch tabs via mouse wheel or, in case they overflow, via distinct scroll controls left and right of the tabbar:

Connector Configuration

We added the ability to configure Camunda connectors. If you select the implementation type connector for a service task a new connector tab will appear. Additionally you get quick feedback on whether the connector is already properly configured. Clicking on the configuration note gets you directly to the tab. There you can maintain the connector details such as id an input/output mappings.

Editable Names

You can now edit the names of individual diagram elements directly in the properties panel. Type ENTER to add pre-formated line breaks to your element labels and the name input box will resize accordingly, too.

What Else

Along with the things highlighted above we added numerous other features, bug fixes and improvements.


  • camunda:properties editable for form fields and as extensions for all elements
  • camunda:in and camunda:out variables editable for call activities
  • Compensation details editable for compensation throwing events
  • Business key can be passed to sub processes (learn more)

Bug Fixes

  • Multi instance configuration fixed
  • Retry time-cycles fixed
  • Event definition properties (for signals, messages and receive tasks) clear properly
  • Escalation and error references fixed
  • ...

Other Improvements

  • Simplified validation
  • Improved structure of the properties panel with groups, labels and dividers
  • Improved undo/redo behavior
  • Bullet proof testing (we added 995 tests while keeping the test suite fast)

What's next

This release of the properties panel is also part of the brand new release of the Camunda Modeler. If you still miss a feature or can't configure a property let us know! Get in touch with us via our forums and tell us what you think.

Make sure to follow us on Mastodon if you would like to keep track on what is happening in the bpmn-io sphere.

Get the latest release of our properties panel via npm.

Are you passionate about JavaScript, modeling, and the web?
Join Camunda and build modeling tools people heart.