Skip to main content
Cloud icon
Cloud

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.
A happy Jira admin

The journey to your dream Jira destination starts right here

Whether you are discovering ScriptRunner for the first time, or 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.

Hey there!

I’m Karl, Product Manager for ScriptRunner for Jira Cloud.
My 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 license.
A photo of Karl Dickman, Senior Product Manager for ScriptRunner for Jira Cloud

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.
illustration of a cog with arrows pointing up
Get ScriptRunner up and running
  1. Install ScriptRunner
  2. Familiarise yourself with the menu and navigation
  3. Install the free Behaviours app
Install Behaviours apparrow icon
illustration of a wrench placed on top of a teal coloured cog
Learn the basics
  1. Explore the documentation pages
  2. Complete Beginners training path
  3. Learn Groovy scripting (and HAPI)
Explore Docsarrow icon
illustration of a script
Run a script
  1. Try a Behaviours script from the in-app available examples
  2. Copy a script from our Example scripts into the Script Console
Visit the Example scripts arrow icon

Essential features

Get familiar with our most popular features!
Illustration of a lightning bolt
Behaviours
Gain control over fields: conditionally change how fields behave when creating a new issue in a project.
Learn more about Behavioursarrow icon
illustration of a target
Built-in Scripts
An alternative to writing your own code: simply complete some fields and these scripts are ready to go!
Learn more about Built-in Scriptsarrow icon
illustration of a brain and a cog working together
Script Listeners
Work with listeners to run an action automatically in response to a specific event in Jira.
Learn more about Script Listenersarrow icon
illustration of a clock
Enhanced Search
Extend Jira's search capabilities and conduct more accurate searches easier and faster.
Learn more about Enhanced Searcharrow icon
illustration of a tin of paint
Scripted Fields
Customise how information for an issue is displayed and show additional, usually unavailable, insights.
Learn more about Scripted Fieldsarrow icon
Illustration of a notepad
Workflow Extensions
Automate and extend your workflows: set up rules, add conditions, validators & post functions.
Learn more about Workflow Extensionsarrow icon
illustration of a book of scripts
Script Fragments
Customise your Jira UI and display useful content from external systems to empower your users.
Learn more about Script Fragmentsarrow icon

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

A person smiling at the camera in front of two illustrated JSM windows, showing icons of people moving from one to the other with pink arrows
How to move JSM users between organisations in bulk
Managing your organisation groups in Jira Service Management just got easier! This step-by-step guide shows you how to move user accounts in bulk, using ScriptRunner for Jira Cloud.
Read morearrow icon
A pair of binoculars are plugged into a Jira board to supercharge your instance
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 morearrow icon
A Jira Kanban board being prioritised
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 morearrow icon
A Jira kanban board surrounded by a lightning bolt and sparkles
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 morearrow icon
A Jira board ticket stamped with the word "Ready"
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 morearrow icon
Multiple checklists being stamped as done once all the tasks are ticked off
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 morearrow icon

Install 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.
illustration of a graduate cap
Beginner
Get to grips with ScriptRunner basics, features and navigation.
Start beginner patharrow icon
Speed meter
Intermediate
Build on your knowledge to create and edit more complex automations.
Start intermediate patharrow icon
Computer screen
Video demo playlist
Expand your knowledge with more videos on different use cases and features.
Watch video demosarrow icon

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 SR4JC

Jira board with colourful icons
Jira
ScriptRunner for Jira
By Verity Blake
 on 
18 June 2025
Unlock effortless scripting with HAPI’s new feature
Read morearrow icon
A person smiles in front of a Jira board, with arrows extending from their fingers pointed upwards. The arrows show the Jira board expanding, surrounded by star icons.
Jira
ScriptRunner for Jira
By Maria Barrios
 on 
17 June 2025
Advanced Jira Cloud automation: Boost efficiency with ScriptRunner
Read morearrow icon