Bulk Change

The Bulk Change feature allows you to apply workflows to multiple Confluence pages in one action using CQL. This is a great way to apply workflows in bulk if you have just installed Workflows for Confluence and are looking for a way to apply specific workflows to pages in your Confluence instance.

Accessing Bulk Change

To access Bulk Change, start by navigating to the Global Confluence Administrator settings. Next click Configuration under Workflows on the left-hand side.

And finally, click into the Bulk Change settings.

In these settings you can now add your CQL mapping to specify which Confluence pages you want to apply a workflow to. Once you have added the CQL query to the field it will notify you if the query is valid or invalid, as shown below.

Once you are ready to apply the workflow to these Confluence pages click Execute.

Supported CQL Fields

Workflows for Confluence currently only supports the following CQL fields:

Field	Property	Example	Notes
Id	Page id	`id = 123456`	Applies the chosen workflow to the page associated with the page id
Ancestor	Page id	`ancestor = 123456`	Applies the chosen workflow to all child pages associated with the parent page, including children of children
Creator	User id	`creator = "99:27935d01-XXXX-XXXX-XXXX-a9b8d3b2ae2e"`	Does not support `creator.fullname`
Label	Name of the label	`label = 'my-label'`
Parent	Page id	`parent = 123456`	Applies the chosen workflow to direct child pages associated with the parent page
Space	Space key	`space.key = ABC`	Does not support `space`, please make sure to use `space.key`
Title	Page title	`title ~ "My Page Title"`

You can also build more complex queries with the use of and and or key words. For example, if you wanted to apply a workflow to a page with id 123456 and all its children, you could use the following query:

CODE

id=123456 or ancestor=123456

If you would like to learn more about these fields, please take a look at Atlassian’s documentation.

Important Note: The first CQL Mapping that matches the page is the workflow that will be assigned to that page.

Need support? We’re here to help 🧡

If you have any questions or would like to speak with us about Workflows, please don’t hesitate to reach out to our Customer Support team.