Getting Started

Get ScriptForge installed and run your first script in minutes.

Prerequisites

  • Jira Cloud instance (any plan — Free, Standard, Premium, or Enterprise)
  • Jira Administrator permissions (required to install Forge apps)
  • A modern browser (Chrome, Firefox, Edge, or Safari)

Installation

  1. Go to the Atlassian Marketplace and search for ScriptForge
  2. Click Get it now and select your Jira Cloud site
  3. Review the permissions (read/write issues, manage configuration, storage access) and click Install
  4. After installation, the app appears under Apps → ScriptForge in your top navigation

First Launch

On first launch, ScriptForge automatically:

  1. Initializes its database — creates SQL tables for listeners, scheduled jobs, workflow rules, and execution logs
  2. Registers event triggers — subscribes to 37+ Jira events for listener support
  3. Activates UI Modifications — enables the Behaviours engine for field-level scripting

No manual setup is required. All features are immediately available.

Your First Script

The fastest way to verify everything works:

  1. Click Apps → ScriptForge to open the admin panel
  2. Click Script Console in the left sidebar
  3. Paste this script:
const me = await Users.getLoggedInUser();
return {
  displayName: me.displayName,
  accountId: me.accountId
};
  1. Click Run
  2. You should see the Forge app service account's display name and account ID in the output panel

What's Available

From the ScriptForge admin panel you can access all features via the left sidebar:

  • Script Console — Ad-hoc script execution
  • Listeners — Event-driven automation
  • Scheduled Jobs — Recurring script execution
  • Workflow Extensions — Conditions, Validators, Post Functions
  • Behaviours — Dynamic field control on issue forms
  • Scripted Fields — Computed custom fields
  • Fragments — Custom UI elements (buttons, panels, menu items)
  • Enhanced Search — Custom JQL functions
  • Built-In Scripts — Pre-built scripts for common tasks
  • Script Manager — Reusable script library
  • Execution History — Logs of all script executions