You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Latest releases

Minimum Compatibility

The current release of Comala Document Management requires Confluence 6.0+ to operate correctly.

Earlier releases

For earlier releases, visit the documentation archive.

Useful links

What's new

Comala Document Management 6.6

Document Management Space Dashboard page

The Document Management Dashboard page has been refreshed.

  • Clarified the enabled/disabled state of each workflow.
  • The workflow diagram can now be found by clicking on the workflow name

Read Confirmation

Comala Document Management 6.6 brings updates to the Read Confirmation feature:

Standalone Read Confirmations

Previously, Read Confirmations could only be used as a part of a page approval workflow. Now Read Confirmations can be added to any page without the need for reviews and approvals.

Setting Due Date

A due date can now be added and updated in the Read Confirmation dialog by clicking on the clock icon.

Read Confirmation request option

At final review, the reviewer can decide if read confirmations should be assigned.

New Read Confirmation Triggers

This release adds several new triggers for Read Confirmation actions:

  • confirmationrequested
  • confirmationdue
  • confirmationcompleted
  • confirmationacknowledged

Comala Document Management 6.5

This is the first release of Comala Document Management 6.5, formerly Comala Workflows. 


The new name better describes the scope and use of the app. While workflows will continue to play an important role, Comala Document Management offers much more than just approval workflows. Teams are not only using our app to add approvals, they’re using it to completely manage their documents. Comala Document Management tells a much more complete story about what our apps can do.

Read Confirmation

This release introduces improvements to our existing Read Confirmations feature:

  • A workflow can now have no states and just the read-ack macro.
  • New users can be added to the list of users already assigned a read confirmation.
  • Send New Request button was added. This action will send a reminder when the page has been updated after being already confirmed.

Manual upgrade of Read Confirmation data

For existing users of Read Confirmation a manual step will be required when upgrading to Comala Document Management 6.5. Please see the upgrade instructions here: Upgrade from 6.4 to 6.5

Comala Workflows 6.4

Approval Roles

This release introduces a new feature that allows approvers to use the optional approval role field to record the roles that your approvers are performing. This is a more flexible method of capturing roles compared to named reviews, and allows you to easily assign ad hoc roles when necessary.

These roles can be created and shared to group other reviewers.

Suggested Contributors

Comala Workflows will suggest assignees that are specified in the user, group, selectedapprover or selectedapprovers parameter on the {approval} macro. If these parameters are not specified, recent contributors to the page will be suggested.

Comala Workflows 6.3

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.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 Using 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: Using 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.