Skip to main content
Book your demo
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 app
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 Docs
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

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 Behaviours
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 Scripts
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 Listeners
illustration of a clock

Enhanced Search

Extend Jira's search capabilities and conduct more accurate searches easier and faster.
Learn more about Enhanced Search
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 Fields
Illustration of a notepad

Workflow Extensions

Automate and extend your workflows: set up rules, add conditions, validators & post functions.
Learn more about Workflow Extensions
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 Fragments
An icon of colourful interconnected circles

Script Manager

An integrated place to save and manage reusable scripts for repeatable logic, libraries, and templates.
Learn more about Script Manager

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 more
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 more
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 more
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 more
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 more
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 more

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 path
Speed meter

Intermediate

Build on your knowledge to create and edit more complex automations.
Start intermediate path
Computer screen

Video demo playlist

Expand your knowledge with more videos on different use cases and features.
Watch video demos

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