SIL Listeners

SIL Listeners automatically execute custom scripts when specific Jira events occur. They serve as integration points that help synchronize your Jira instance with external systems, enforce business rules, or automate workflows.

How listeners work

When a Jira event occurs (such as creating an issue or adding a comment), Power Scripts detects the event and executes your configured listener script.

At its core, a listener is defined by two elements:

The script the listener executes.
The events it's configured to react to.

Power Scripts for Jira Cloud operates independently from Jira and communicates through HTTP API calls, making all interactions inherently asynchronous. However, you can configure individual listeners to execute in two modes:

Synchronous execution: The script runs immediately and can affect the triggering operation.
Asynchronous execution: The script runs in the background without blocking Jira operations.

For detailed guidance on choosing the right execution mode, see Understanding Synchronous vs Asynchronous execution.

In this section:

Listener configuration

This page covers how to create, configure, and manage your SIL listeners, including understanding the events they can respond to.

Understanding listener execution

This page explains how SIL listeners execute in Power Scripts for Jira Cloud, including the choice between synchronous and asynchronous execution modes.

Understanding listener script context

This reference helps you understand what data your listener scripts can access and which functions to use based on whether your script runs in Issue context or Global context.

Listener implementation examples

This guide provides a step-by-step walkthrough for creating two different types of issue listeners in a system using SIL Manager. You will learn how to set up listeners that automatically add comments when an issue is created and when an issue's fields are updated.