Edit, copy, and delete automation rules in Confluence Cloud

Automation is available with Confluence Premium and Enterprise.

Site admins and Confluence admins can turn automation rules on and off, copy them, or delete them at the global level. Space admins can turn rules on and off, copy them, or delete them for individual spaces.

While you may not think of yourself as an admin, if you have a personal space you’re an administrator of your space!

This includes the rules tied to smart buttons. When a smart button’s rule is turned off or deleted, it will not work and users selecting it will see an error message.

View rules in Global Automation (site admins, Confluence admins)

To navigate to Global automation:

Only site admins and Confluence admins can view Global automation.

  1. Select the wheel icon () in the top-right corner to open Confluence administration.

  2. Find Admin tools in the left-hand navigation.

  3. Select Automation.

View rules in space automation (space admins)

To navigate to space automation (space admins):

  1. Go to the space where you’d like to manage your rules.

  2. From the sidebar, select Automation.

  3. Select Rules from the Automation card.

To access space Automation from a page (space admins):

  1. Go to a space where you're an admin.

  2. Open a page in view mode.

  3. On the top right toolbar, select the lightning bolt icon or press a.

Menu shows lightning bolt icon for automation at the top of a published page

If you don’t see Automation in Confluence administration or Space settings, this might be why:

  • You're on the Space Overview page, a whiteboard, or a database. The automation icon appears only on pages in view mode.

  • You’re not an admin of the space you’re in (for Space automation).

  • You’re not a site admin or Confluence admin (for Global automation).

  • Your team has Cloud Standard or Cloud Free – automation is a premium feature in Confluence.

 Manage automation rules (all admins)

Once you’re in Global automation or Space automation, your options to manage rules are the same. You can turn a rule on or off, copy a rule, label a rule, or delete a rule.

Site admins can disable the ability for space admins to edit rules. If you don’t have edit access to your space’s automation rules, contact your site admin.

 

The admin's view of automation rules in Confluence

Rule filters

The top of the list of rules provides several ways to filter it.

  • Search field: Enter text to filter by the names of your rules.

  • Scope: Choose to view All rules, Global rules, or Space rules.

  • Action: Find rules that include a specific action. Choose from a drop-down list or search by the action’s name.

  • Labels: Select the Labels button to filter rules by a specific label.

Turn a rule on or off

Each rule has a toggle to enable it. Turning the rule off in Global Automation will turn it off for all sites. Turning a rule off in a space only affects that space.

Delete a rule

  1. Select the more actions menu (ellipsis icon).

  2. Select Delete.

  3. Confirm that you want to delete the rule by selecting OK.

If you delete a rule connected to a smart button, all copies of that button on any page or blogpost will stop working.

Copy a rule

  1. Select the more actions menu (ellipsis icon).

  2. Select Copy.

  3. The rule-builder opens with a copy of the rule. You can modify any component.

  4. When you select Turn on rule, you will need to give it a uniwue name.

Export a rule

  1. Select the more actions menu (ellipsis icon).

  2. Select Export.

  3. A .json file will download to your computer. It contains the code used to run the rule.

Labeling rules

  1. To apply a label to a rule, click the space under the Labels column.

  2. A list of labels opens, along with a text field to create a new label.

The Edit labels button in the table header lets you modify the name or color of any label.

Viewing the audit log

Each of your rules will have an audit log that you can review to see when the rule was triggered, the final result of the execution, and any actions that may have been performed in the last 90 days.

Select the Audit log tab to view the last 90 days of activity in your space or Global Automation (depending on your admin level).

For each rule execution, the audit log will display:

  • Date: the date and time that the rule was triggered.

  • Rule: the name of the rule.

  • Status: the status of the rule execution.

  • Duration: the length of time the rule took to execute.

  • Operations: the actions that the rule performed and any associated items.

You can view the audit log of an individual rule, at the project/space level, or for all rules in a product. Reviewing your audit logs is an effective way of debugging your rules.

Note that audit log entries are stored for 90 days; entries older than this are removed from the log and can't be recovered.

 

Still need help?

The Atlassian Community is here for you.