Introduction to Groovy

ScriptRunner allows you to create custom scripts using the Apache Groovy language. Apache Groovy is both a dynamic and static language; it has been created for the Java platform, meaning seamless integration with Jira, Confluence, Bitbucket, and Bamboo.

Apache Groovy is a programming and scripting language, and therefore you do not need to define a class to be able to run code. With its powerful features, the use of Apache Groovy in ScriptRunner allows for a high level of customisation.

Learning Apache Groovy

There are many great resources available to help you learn how to code in Apache Groovy. We suggest you look at the official Apache Groovy website for a list of learning resources including books, presentations, and courses. Apache Groovy also provides extensive reference material and get started documentation.

We intend this page to be a list of useful resources for self-learning. Adaptavist Support cannot help with any training in Apache Groovy.


Using Apache Groovy in ScriptRunner

You can use Apache Groovy scripts to customise the majority of ScriptRunner features. Apache Groovy scripts can be inserted anywhere a 'Script' or 'Condition' field is found. You can enter Apache Groovy scripts directly into the ScriptRunner front-end, or select one of the .groovy files stored in the Script Roots directory on the server.

Want to make your Apache Groovy scripts easier for non-technical users to customise? Try the Dynamic Forms feature.


Check out our Groovy Scripting for ScriptRunner webinar to see how you can parse irregular data and find affected issues by combining Apache Groovy, scripted fields, and JQL.

We regularly run champion hour Q&A sessions to answer a host of questions about our products, including ScriptRunner and the use of Apache Groovy.

  • Champion Hour Q&A - Hear from our team of experts on how to get the most out of your Adaptavist and Atlassian solutions.

  • ScriptRunner Q&A - Listen to our dedicated team of engineers answering technical questions about using ScriptRunner.

Example Apache Groovy Scripts for ScriptRunner

Visit the Adaptavist Library for a collection of tailor-made Apache Groovy scripts for use in ScriptRunner. Either copy these scripts directly into your instance or edit them to fit your needs.

On this page