Comala Workflows is now Comala Document Management. Click here for the latest documentation.

What's new

Comala Workflows 6.2

Require Parameters on State Transitions

This release introduces a new feature that lets teams configure workflows to require a parameter field entry when changing states.

Workflow Parameters have long provided a convenient way to configure a workflow. But, up until now users could only enter the configuration values when the workflow started, or by accessing a separate menu. With this release workflow authors can now require that a specified parameter value is entered on a transition to a new state.

Comala Workflows 6.1

Improved Workflows Dialog Layout

The visual design of the Workflows Dialog Pop-up has been improved. It's now easier to use, and is up to date with the latest Confluence styling.

Updated minimum Confluence compatibility

Starting with Workflows version 6.1.0, the new minimum version of Confluence that the app is compatible with is Confluence 6.0.1.

Comala Workflows 6.0

Confirm Reading Approved Content

You can now use the final state in your workflow to start a Read Confirmation process. Use it to assign users to read the approved page, and get an acknowledgement from users that have read it. 

Built on the same dependable, familiar functionality of Comala Workflows, Read Confirmation helps teams keep track of who has been assigned to read documents, and who has acknowledged that they have read them. The confirmation can be assigned to multiple individual users or an entire group of users. It is integrated with the approved page workflow functionality, so people can confirm reading the existing approved version of a page while new edits are taking place. Once a new approved version is created, the Read Confirmation process will be restarted. 

New Space Workflow Report

The space level workflow report received a makeover in this release. We have completely rebuilt the front end to allow selectable columns, and the backend to improve performance and to allow for future integration extensibility.

Comala Workflows 5.11

New Onboarding for Workflows

This release adds introduction information about Comala Workflows for new users to Confluence.


For this release there is a introduction screen as well as a in page message for page authors to let them know about the new functionality.

(The on boarding feature can be disabled via an admin setting for Confluence sites that have their own training material already.)

Comala Workflows 5.10

Improvements to the Workflow Builder

The Workflow Builder now allows to switch between the Markup Editor and Workflow Builder views directly without needing to exit the Builder.

Other fixes and updates

  • A new Value Reference Modifiers has been added so you can quickly turn user value references into user's full names @approvaluser > fullname@

Comala Workflows 5.8

Improvements to the Workflow Builder

We've taken the initial release of the workflow builder that was released last month and given it a new paint job and made several bug fixes and improvements that didn't quite make it in time for the first release.

Comala Workflows 5.7

Workflow Builder is now available

Workflows 5.7 now includes the first public release of the Workflow Builder.  You can now edit workflow states, transitions, approvals and other parameters through a graphical interface. 

Comala Workflows 5.6

Workflows support for Read Only Mode

Workflows 5.6 has been updated to support the new Confluence Data Center 6.10 Read Only Mode feature. Features that are not available in Read Only Mode will display messages to inform the user that the functionality is unavailable at the moment.  See Read Only Mode Behaviour for more information.

Comala Workflows 5.5

New workflow trigger events for comments

New events have been added for page and inline comments.

For pages:

  • pagecommentcreated
  • pagecommentupdated
  • pagecommentremoved

For Inline comments:

  • inlinecommentcreated
  • inlinecommentresolved

More information can be found in the Events page.

Restrict who can assign approvals

New parameters have been added for Approvals: allowedassignusers and allowedassigngroups, these 2 parameters determine users and groups allowed to assign approvals. More information can be found in the approval macro page.

Comala Workflows 5.4

Attachment Version Removed Trigger

A new trigger event has been added that allows the workflow to take an action when an attachment version is removed.

Beta Workflow Builder

We are working on a new graphical way to create and edit your workflows.  Included in this release is our first iteration that will support viewing and changing some basic workflow attributes for space level workflows.  For more information on this project please see: Workflow Builder

We will be rolling out more updates progressively over the next few releases.

Comala Workflows 5.3

Confluence Look and feel updates

Those using recent versions of Confluence will notice that the page level Workflows elements now look like they belong a bit better with an update to the latest UI library from Atlassian.

Before: Confluence 6.6

After: Confluence 6.7+

New Workflows Picker

We completely revamped the page workflows picker to provide all the relevant information when adding a workflow to a page and let space admin users jump directly to add the workflow to the entire space.

User Tasks Report now support pagination

This improvement removes the previous limit of 20 entries, displaying now any number of items.

New Global settings for Allowing/Restricting Space and Page Workflows

Before, you just could define in which spaces workflows were allowed. Now, you can choose, either to allow, or to restrict those spaces.

Comala Workflows 5.2

Workflow Messages view and role specific

The messages displayed using the set-message macro can be now be specific to the page view and users/groups.

  • Use the new group parameter to specify a message to be displayed to a group of users.
  • Use the new view parameter to control if a message should be visible on the published (public) or normal view of a page.

Comala Workflows 5.1

Customizable State Colours

States can now be given their own custom colours. Using the Workflows Mark-up Editor you can set the color of your states to be nearly any shade, provided it is available as a hexadecimal value.

See the colour parameter on the state macro for more information on this new feature.

Approval Action Labels

Approvals can now be given custom action labels. Replace the standard "Approve/Reject" with custom labels such as "Agree/Disagree", "Yes/No" or any combination that fits your workflow's needs.

Refer to the approval macro and the new approvelabel and rejectlabel parameters for use in your workflow markup, they allow you to change the default labels. At this time the labels are only applied in the user interface; when you view the workflow activity reports the default action names will still be applied.

Comala Workflows 5.0

Redesigned Page User Interface

Comala Workflows 5.0 features a new interface for managing states, approvals and tasks on Confluence pages.

First released in v4.18 as a dark feature, version 5.0 makes the new UI standard for all users. The new UI is built to be:

  • Intuitive, and aligned to Atlassian’s latest design principles.
  • More accessible and easier to use.
  • Smarter, and with a better UX.

We thank all the users that provided their feedback during the beta period. Of course we aren't going to stop the improvements there, so if you have feedback about the new user interface please let us know.

Supported REST API

For the first time, Comala Workflows now includes a supported REST API to complement the existing Java API.  This initial release focuses on content level APIs, so you can retrieve the status and interact with the workflows on individual pages.

You can read more about integration options with Comala Workflows on our Workflows Developer Guide.

Workflow Builder is now available

Workflows 5.7 now includes the first public release of the Workflow Builder.  You can now edit workflow states, transitions, approvals and other parameters through a graphical interface.