The Adaptavist Group LogoDocumentation

Extend Jira Automation with ScriptRunner

ScriptRunner for Jira Cloud complements Jira Automation by enabling code-based automation, advanced workflow logic, API integrations, data transformation, reusable scripts, and admin-level automation. ScriptRunner is best suited to advanced automation scenarios where you need greater flexibility.

When to use ScriptRunner or Jira Automation

We've provided a comparison of the capabilities of ScriptRunner for Jira Cloud and Jira Automation below to help you determine which tool is most appropriate for a given use case.

Use ScriptRunner when you need:

  • full programming capabilities using Groovy, Typescript/JavaScript, HAPI, or assisted scripting
  • a Script Console to run and debug scripts on demand against your live instance before deployment
  • reusable scripts via the Script Manager
  • advanced Workflow Rules such as Validate Details, Restrict Transitions, and Perform Actions
  • dynamic field control and user-specific field visibility using Behaviours
  • calculated custom fields using Scripted Fields
  • custom JQL functions and keywords using ScriptRunner Enhanced Search
  • complex data transformation, including parsing JSON or XML and manipulating collections
  • advanced REST API calls and response parsing
  • secure credential storage using Script Variables
  • custom retry logic and more detailed error handling
  • bulk work item processing and complex multi-work item operations
  • admin-level actions such as managing users, groups, and space roles

Use Jira Automation when you need:

  • a visual drag-and-drop builder
  • quick no-code rule creation
  • simple event-driven automations
  • basic branching and workflow extensions
  • space-admin access to create and manage automation rules

Capability comparison table

CapabilityScriptRunner for JiraJira Automation
Rule builder styleCode-basedVisual drag-and-drop
Execution modelDirect script executionQueued, subject to Atlassian throttling
Programming supportGroovy, Typescript/JavaScript, HAPI, assisted scriptingLimited to no-code and smart values
Space supportCompany-managed and team-managed spacesCompany-managed and team-managed spaces
Workflow RulesAdvanced validators, conditions, and post-functionsBasic workflow extensions
Dynamic field controlStatic field configuration only
User-specific field visibility
Calculated custom fields
Custom JQL functions and keywordsStandard JQL only
Complex data transformationLimited smart value functions
Advanced REST API callsBasic "send web request" support
API response parsingProgrammatic parsing of JSON and XML responses, including nested structures, conditional logic on response data, and error handlingLimited parsing
Secure credential storageScript Variables, centralised, encrypted credential storage, reusable across scriptsNo central credential store or cross-rule reuse
Custom retry logicExponential backoff and custom error handlingNot supported
Bulk work item processingLimited bulk actions
Complex multi-work item operationsConditional hierarchy and multi-work item processingBasic branch rules only
User and group managementSupportedNot supported
space role managementSupportedNot supported
Error handlingTry/catch, custom retry, detailed loggingBasic continue-on-error behavior
Code reusability
Interactive testingScript Console for rapid pre-deployment testingBuilt-in rule testing and audit log for reviewing execution history
Who can create automationsUsers with access to the ScriptRunner administration panel, typically Jira Admins. Access is configurable per instance.Space Admins and Jira Admins

Search documentation

Start typing to search the docs.