Skip to main content

Script Master FAQ

Short answers to common questions about Script Master for Jira and Script Master for Confluence. For step-by-step help, follow the links.

General​

Who can use Script Master?​

Jira admins and Confluence admins. Opening the Script Master admin page needs the Administer Jira global permission in Jira, or Confluence administrator rights in Confluence. People without admin rights see what your scripts show them, such as fragments, gadgets and macros, and can use the Script Master Tools you give their groups access to. Permissions lists who can reach each part of the app.

Does Script Master for Jira work with Jira Service Management?​

Yes. Fragments can show on the queue pages of a service space, and UI modifications can run on request forms in the service portal. See Fragments and UI Modifications.

Which modules need the Companion App?​

The ones that run on a server: web triggers, scheduled jobs, scripted custom fields and workflow post functions. The Script Console, fragments, gadgets, macros, UI modifications, validators, conditions and Script Master Tools work without it. The Companion App is a small Forge app you deploy under your own developer account, as The Companion App explains.

Can I see who changed a script, and undo a change?​

Yes. Each list shows who created and last updated every item. Every save also adds a version, and you can compare two versions and restore an old one. Versions cover fragments, gadgets, macros, web triggers, scheduled jobs, UI modifications, scripted fields and workflow rules. See Version history and Audit metadata.

Does Script Master have listeners?​

No. To run a script when something happens, such as a new work item, call a web trigger from a Jira Automation flow. See Listeners.

What happens when the license ends?​

Your items stay as they are, but you can't create items or run scripts from the admin page until the license is active again. See Licensing.

Scripts​

Who does a script run as?​

It depends on where it runs. The Script Console, fragments, gadgets and macros run in the browser as the person using them, with that person's permissions. Web triggers, scheduled jobs, scripted fields and post functions run on the server as the app. See Forge bridge API for browser scripts and Forge API for server-side scripts.

Can an AI assistant write my scripts?​

Yes. Build script with AI in the code editor opens Claude, ChatGPT or Gemini with a prompt that explains how Script Master scripts work, or gives you the prompt to paste into another assistant. Each module also has an AI prompt page. See Build a script with AI.

Can I edit scripts in my own code editor?​

Yes. The external editor connects an editor on your computer to Script Master and reloads the script as you save.

UI modifications and workflow rules​

Do UI modifications stop people from saving incomplete work items?​

Only on the forms they run on. Board inline create, the REST API, automation and bulk edit skip UI modifications. To block a missing value everywhere, add a validator to the workflow as well. See Require details for urgent work.

Do I need to write code for a validator or condition?​

No. Build it from checks such as Assignee is set, and Script Master writes the Jira expression for you. See Build a rule without code.

Web triggers​

Are web triggers secure by default?​

No. Anyone who has a web trigger's URL can call it, and the script runs as the app. Check a secret token at the start of every web trigger script. See Require a token on a web trigger.

Can a Confluence page show data from Jira?​

Yes, through a web trigger in Script Master for Jira that a Confluence fragment or macro calls. See Show Jira work item statuses on a Confluence page.

Scheduled jobs​

Why didn't my scheduled job run at the exact time I configured?​

Script Master checks schedules once an hour, so a job can start up to an hour after its time. Schedules are in UTC. Don't build a job that depends on an exact start time. See Schedule a job with cron.

Do failed runs of a scheduled job show in its history?​

Yes. A run that throws an error is recorded in the job's History column, with the error and the lines the script logged. Each job keeps its last 10 runs. A run that Forge stops before the script returns, for example at Forge's time limit, leaves no record. See Check a job's runs and failures.

How do I test a scheduled job?​

In the job's editor, turn on Test this Scheduled Job and select Test. The test runs the code in the editor, saved or not, and shows its result and output. To run a saved job now, select β€’β€’β€’ > Run in its row on the Scheduled Jobs tab. A test runs the script for real, so it changes data the same way a scheduled run does. See Test or run a job now.

Scripted custom fields​

My scripted custom field shows an empty value on existing work items. Why?​

Jira asks for a scripted field's value only when someone opens a work item that shows the field. Until then, the field has no stored value. It also stays empty when the Companion App isn't set up, when the script fails or returns the wrong type, or when it takes longer than 25 seconds. Check the script with the field preview.

The field value doesn't update when automation or the REST API changes a work item. Why?​

Jira computes the value again only when someone opens the work item. Searches, filters and lists show the value Jira stored the last time. See Scripted custom fields.

What return types are supported for scripted custom fields?​

One per field type: a number, a string, a user object with an accountId, an ISO 8601 date and time, or a YYYY-MM-DD date. See the table in Scripted custom fields.

Security and data​

Does Script Master send data outside my Atlassian site?​

Yes, in three cases. Server-side scripts and their inputs go to your Companion App to run. Your scripts send data wherever their code calls. Script Master sends error reports from its own code and usage counts to Sentry in the US, unless an admin turns them off. Your scripts, their output and your content are never in those reports. See Data security and privacy.

Where does Script Master store my scripts?​

Fragments, gadgets, macros, web triggers, scheduled jobs, UI modifications, their versions, run history and settings are in Forge hosted storage for your site. The code of scripted fields and workflow rules is stored in Jira's own configuration. See Data security and privacy.

Can I turn off error reports and usage counts?​

Yes. In Script Master, open Settings and turn off Send error reports and usage counts. The app works the same with the setting off. See Settings.

Support​

How do I get help?​

Open a request in our support portal, with the product (Jira or Confluence), the module, what you did and what you saw.