Check out what’s new for ScriptRunner for Confluence Server.


New Features

The Add/Remove Restrictions built-in scripts has been added for space admins.

Bug Fixes

  • SRPLAT-1221 - Bitbucket/Confluence/Jira is no longer prevented from correctly shutting down when ScriptRunner is installed.

  • SRCONF-1209 - Bulk Add/Remove Labels now has consistent case-sensitivity handling.

  • SRCONF-1181 - The editor no longer loads blank page when using a template with the Create Page macro. See SRCONF-1479 for the feature request to add more advanced support for templates.


Space Admin Permissions Moved to Settings Page

To be more consistent with the rest of the permissions and product settings, permissions to restrict access to the Advanced Space Functionality have been moved to the Settings tab.

Notably, this included some changes to the underlying data schema. These will be invisible to users who follow a normal upgrade path, but it will mean that downgrading to prior releases after upgrading and making changes to permissions could see those changes disappear after a downgrade.

Rename titleTransform to pageTransform for Copy Page Tree and Rename Pages

The Copy Page Tree and Rename Pages built-in scripts have a blank code field that had the titleTransform closure included in the field’s binding. The closure allows you to make modifications to pages during the copying and/or renaming process.

That titleTransform closure is now named pageTransform. Since the closure can modify more than just the page title, this name better describes it.

Bug Fixes

  • SRPLAT-1319 - Custom scripts returning String from getHelpUrl() did not work.

  • SRCONF-1407 - Script Jobs did not start after a restart.

  • SRCONF-1121 - Edit page restrictions prevented unauthorised users from using the Create Page macro.

  • SRPLAT-1313 - Script configurations can now be saved with a blank inline script.

  • SRCONF-1453 - The Legacy Page Information macro storage format was incompatible with the ScriptRunner-based Page Info macro.


Ceasing Development on 6

We are no longer developing new features for ScriptRunner versions running on Confluence 6. See our Confluence 6 Development statement for more information.

Bug Fixes

  • SRCONF-1420 - There was an exception when trying to run the Rename Labels script.


Bug Fixes

  • SRCONF-1408 - There is now better validation for missing labels in the Rename Labels built-in script.

  • SRCONF-1330 - The Page Property Reports Macro failed when it contained a custom macro.


Retiring Support for Internet Explorer

From Feburary 1st 2021 ScriptRunner will no longer support Internet Explorer. See our full statement for more information.

Age Picker Field for Jobs

The Prune Old Page Versions and Old Content Notifier jobs have a more flexible and friendly way to specify the age of old content that needs to be cleaned up.


Ability to Disable Switch User Built-in Script

The Switch User built-in script allows administrator users to temporarily assume the identity of another user.

This script is enabled by default. However, if you have extremely strong compliance requirements, you may wish to disable this feature.

This release adds a toggle to the Settings tab to disable the Switch User built-in script. When the script is disabled, it is not accessible for any user (including system administrators).

For more information, see the Disable Switch User Built-in Script documentation.

Bug Fixes

  • SRPLAT-1227 - Documentation links were missing from scripts.

  • SRPLAT-1217 - The Switch to a Different User script banner broke TinyMCE 4 functionality.

  • SRCONF-1091 - On the Database Connection Resources page, the checkbox overlapped with text.

  • SRCONF-1386 - The age picker field validation was fixed.

  • SRPLAT-1213 - "test on borrow" should be the default for LDAP connections

  • SRCONF-1009 - Some scripts do not link to proper location in docs

  • SRCONF-1386 - Fix Age Picker Field Validation


This release backports some fixes for users still on Confluence 6.10.0 through 6.15. We continue to focus our primary development efforts on Confluence 7.x, and encourage our customers to upgrade at their earliest convenience.

Bug Fixes

  • SRCONF-1330 - The Page Property Reports Macro failed when it contained a custom macro.

  • SRCONF-1424 - DiagnosticsLoggerManager is compatible with com.atlassian.logging.log4j.layout.JsonLayout on Confluence 6.


New Features

Watch Descendants is Now a Native Feature of ScriptRunner for Confluence

We have (finally!) finished migrating the core feature of the Notifications for Confluence plugin into ScriptRunner for Confluence as a native feature. Being able to watch the descendants of a page is a much sought-after feature in Confluence, and we’re glad to make it an important ScriptRunner for Confluence feature. You can read more in the descendants documentation.

Upgrade Path

If you have the Notifications plugin installed, uninstall the old Notifications plugin, then update ScriptRunner for Confluence. There won’t be too much harm in having the old plugin installed alongside the update, but that creates two Watch Descendants checkboxes, which would be confusing for end-users.

If you weren’t using the Notifications plugin, you only need to upgrade ScriptRunner for Confluence as you normally would.

Warning: No Data Migration

Any pages marked as Watched by the old plugin are still watched, but the information about which ancestor pages have the Watch Descendants checkbox ticked will not be migrated. If you were using the old Notifications plugin, end-users need to click Watch Descendants again on any pages that they wish to watch all descendants of.

Our rationale for avoiding data migration is that most of the problems with the old notifications plugin centered around its own migration tasks from an early data schema to a new one. Rather than put all ScriptRunner for Confluence customers at risk for similar problems, we decided to make a clean break between the old Notifications plugin and the new one.

A Word on Performance

We have tested the Watch Descendants feature against very large page trees under high load. It performs consistently with Atlassian’s load profiles for Confluence, and it performs as well as or better than the old Notifications app, which was itself used in some large production instances of Confluence.

Bug Fixes

  • SRPLAT-1213 - Test on Borrow should be the default for LDAP connections.


Bug Fixes

  • SRPLAT-11 - An invalid user-configured raw XML script fragment could have prevented the ScriptRunner plugin from enabling.


New Features

  • SRCONF-1021 - The Age Picker field for Bulk Delete Comments now gives you more flexibility to specify which comments to delete.

Bug Fixes

  • SRPLAT-1171 - The Confluence-specific scriptMacroMetadataProvider module no longer shows up in UPM for all ScriptRunner products.

  • SRCONF-713 - The gears icon for lazy loading on script macros was not loading and threw a 404 error.


Bug Fixes

  • SRCONF-1051 - The link to a content indexing section led to a page with a missing tab error.


New Features

  • SRCONF - 1020 - The Age Picker field for Bulk Delete Attachments now gives you more flexibility to specify which attachments to delete.

Bug Fixes

  • SRPLAT-1139 - Compilation failures in one script caused entire features to fail.

  • SRPLAT-1131 - You now have the ability to set all Hikari pool configuration parameters when using database connections.

  • SRPLAT-1094 - Autocompletion requests failed when requesting autocomplete after typing "Check."

  • SRCONF-1282 - Macros were broken on Windows Server.

  • SRCONF-1205 - ScriptRunner for Confluence is now compatible with the Confluence 7.5 EAP.


Bug Fixes

  • SRPLAT-1119 - Classes in scriptrunner-API/SPI were no longer consumable by dependent plugins.


Groovy Upgrade

The version of Groovy used by ScriptRunner has been upgraded from 2.4.15 to 2.5.11. Improvements and new features (like additional AST transformations, or the new tap() method) shipped in Groovy 2.5 are now available to ScriptRunner users. See the Groovy 2.5 Release Notes for more information.

As with any dependency upgrade, breaking changes could potentially affect users' scripts. However, the breaking changes between Groovy 2.4 and 2.5 are relatively minor. The low-level nature of most of these breaking changes means they are unlikely to impact many ScriptRunner scripts if any.

Take a look at the list of breaking changes in the Groovy 2.5 Release Notes for further details.

IntelliJ Removal

This version removes all support for the IntelliJ IDEA plugin. See our previous deprecation announcement for our rationale and plans for the future.

New Features

  • SRPLAT - 1063 - The Add Watchers built-in script is now available.

Bug Fixes

  • SRPLAT-1092 - There is now DocLink support for absolute URLs.

  • SRPLAT-1084 - The autocompletion window of the Script Console now closes correctly.

  • SRCONF-1205 - ScriptRunner for Confluence is now compatible with the Confluence 7.5 EAP.

Have questions? Visit the Atlassian Community to connect, share, and learn with other Atlassian users and experts, including Adaptavist staff.

Ask a question about ScriptRunner for JIRA, Bitbucket Server, or Confluence.

Want to learn more? Check out courses on Adaptavist Learn, an online platform to onboard and train new users for Atlassian solutions.