Get started with ScriptRunner for Jira Cloud
Welcome to ScriptRunner, your complete solution to automate, customise and extend Jira. Discover all the resources you could ever need right here.
The journey to your dream Jira destination starts right here
The ScriptRunner team is on a mission to build your favourite Jira Cloud app, unlocking new possibilities for you, our customers, and expanding the limits of Jira. Through ongoing development and support, we aim to help you get the most out of ScriptRunner, whether you're currently on a free trial or paid licence.
Whether you are discovering ScriptRunner for the first time or you’re a seasoned pro, you will find all the resources you need below. Make sure to bookmark this page so you can refer back to it throughout your ScriptRunner journey. And if there's something you need that you can't find? Please raise a support ticket and our team can help you.
New to ScriptRunner for Jira? Take a product tour!
Learn how to navigate and use ScriptRunner for Jira Cloud with Bobby Bailey, Customer Success Advocate.
Getting started
With access to extensive documentation, video training, a team of experts and more than 100 example scripts, you have all the resources necessary to make your ideas a reality. And the best part? ScriptRunner has made coding simple, fast and intuitive with HAPI - your go-to scripting companion that enables you to write code the way you think.
Whether you're a seasoned expert or just starting out, ScriptRunner equips you to reach the full potential of Jira.
Get ScriptRunner up and running
- Install ScriptRunner
- Familiarise yourself with the menu and navigation
- Install the free Behaviours app
Learn the basics
- Explore the documentation pages
- Complete Beginners training path
- Learn Groovy scripting (and HAPI)
Run a script
- Try a Behaviours script from the in-app available examples
- Copy a script from our Example scripts into the Script Console
Essential features
Get familiar with our most popular features!
Behaviours
Gain control over fields: conditionally change how fields behave when creating a new issue in a project.
Built-in scripts
An alternative to writing your own code: simply complete some fields and these scripts are ready to go!
Script Listeners
Work with listeners to run an action automatically in response to a specific event in Jira.
Enhanced Search
Extend Jira's search capabilities and conduct more accurate searches easier and faster.
Scripted Fields
Customise how information for an issue is displayed and show additional, usually unavailable, insights.
Workflow Extensions
Automate and extend your workflows: set up rules, add conditions, validators & post functions.
Script Fragments
Customise your Jira UI and display useful content from external systems to empower your users.
Script Manager
An integrated place to save and manage reusable scripts for repeatable logic, libraries, and templates.
Meet HAPI, your scripting sidekick
ScriptRunner has opened the doors of coding to administrators of any background.
HAPI is a simpler alternative to Jira and Confluence API. Using plain Groovy, it significantly simplifies the way you write scripts in ScriptRunner, whether you’re searching, managing issues, or updating fields. With HAPI you can create automations faster and easier than ever before, whether you’re an expert or a beginner.
Get inspired
Catch up on the latest news from the ScriptRunner for Jira Cloud team
Read the latest tutorials from the ScriptRunner for Jira Cloud team
How to trigger a ScriptRunner action from native Automation
Ever wanted to combine the convenience of native Automation with the bespoke automations of ScriptRunner? Check out this tutorial to find out how!
Read more
How to create dynamic dashboards using Enhanced Search filters
In this tutorial, you can learn how to leverage Enhanced Search filters to optimise your dashboards and discover best practices for setup, maintenance, and sharing.
Read more
How to generate a Sprint Workload Report
A Sprint Workload Report keeps your sprints running smoothly. Find out how to create this report out-of-the-box with Jira Cloud, and how to automate this reporting with ScriptRunner.
Read more
How to sync Groups with the Team field on Jira
Tired of bumping up against the restrictions of Team fields? Wish they were a little more like Groups? In this tutorial, you’ll learn how to go beyond what's possible with native Jira automation and consolidate the Team field with Groups to harness their combined power.
Read more
Create winning user stories with a Definition of Ready
In the agile world, a Definition of Ready ensures that stories are properly completed before work begins. Read on to learn how to create your own Definition of Ready.
Read more
How to align your team on the Definition of Done: Cloud tutorial
Done can mean different things to different people at different stages of the project. To clear up any misunderstandings, we decide on a Definition of Done.
Read moreInstall Behaviours
Behaviours is the most popular feature of ScriptRunner for Jira Cloud. It is available as a free companion app and you can install it either from the Atlassian Marketplace or directly from the main ScriptRunner app.
If you're trying to administer or even just use Jira without ScriptRunner, you're doing it wrong.
April
Review from Atlassian's Marketplace
Keep up to date
Visit the Product Updates Hub to discover what's new and what's next at ScriptRunner.
Training courses
We have a training path for every level of user, to help you become a ScriptRunner pro.
Intermediate
Build on your knowledge to create and edit more complex automations.
Video demo playlist
Expand your knowledge with more videos on different use cases and features.
Talk to a ScriptRunner expert
Book a 30-minute video call with one of our Customer Success Advocates to accelerate your Jira automation journey
Great app with even greater support! Very happy with the assistance I get when writting complex scripts.
Bianca
Review from Atlassian's Marketplace
Atlassian Community
If you're stuck, check out the Atlassian Community! Someone may already have asked and answered your query, and if not, you can ask the thousands of experienced users for help.
Need more help?
Can't find what you're looking for? Talk to our expert teams.
Read the latest news from ScriptRunner for Jira Cloud
ScriptRunner Migration Suite
Jira
By Verity Blake
on
19 May 2026
How ScriptRunner Migration Suite outperforms generic AI in Cloud migrations
Read more
Jira
Cloud
By Andrei Cuzuioc
on
26 February 2026
How Life in Codes and ScriptRunner turned 'impossible' into reality for a global solar energy technology pioneer
Read more
ScriptRunner for Jira
Jira
By Verity Blake
on
29 January 2026