Skip to main content

Install, update and uninstall the app

Install Script Master on your Jira or Confluence site, keep it up to date, and know what happens to your scripts when you remove it.

Before you begin​

  • You need to be a site admin, or a Jira admin or Confluence admin for the product you install it on.
  • Script Master for Jira and Script Master for Confluence are separate Marketplace listings with separate licenses. Install each one you need:

Install the app​

  1. In Jira or Confluence, select Apps > Explore more apps.
  2. Search for Script Master, then select the app for your product.
  3. Select Get app (or Try it free) and follow the prompts.

Result: Script Master appears in your product's admin settings, and the Script Master Tools page is available to the people you give tool access to. See Using Script Master.

Web Triggers, Scheduled Jobs, Custom Fields and workflow post functions also need the Companion App before their scripts run. See The Companion App.

Open the app from Atlassian Administration​

In admin.atlassian.com > Apps > Sites > your site > Connected apps, Script Master is listed as Script Master for Jira or Script Master for Confluence. Each row has a View app details link and a β€’β€’β€’ menu:

EntryWhat it opens
β€’β€’β€’ > ConfigureThe Script Master admin page, starting on the Overview tab
β€’β€’β€’ > Get StartedThe Get started page, with first steps and examples
View app detailsThe app's details, with Uninstall and the data access settings

Update the app​

Most updates reach your site automatically, with nothing to approve.

Some updates are major versions: they ask Atlassian for new permissions, so Atlassian waits for an admin to approve them. Until then, your site keeps running the previous version.

  1. Go to admin.atlassian.com and select your organization.
  2. Select Apps > Sites > your site > Connected apps.
  3. Find Script Master for Jira or Script Master for Confluence, and approve the update.

If Script Master shows This version is outdated, the version on your site has been retired and you need to approve the update. See This version is outdated.

The Companion App doesn't update itself. It's your own Forge app, so you deploy new versions of it yourself. See The Companion App.

Uninstall the app​

  1. In Connected apps, select View app details for Script Master for Jira or Script Master for Confluence.
  2. Select Uninstall and confirm.

What happens to your data:

  • Items stored by Script Master (fragments, gadgets, macros, web triggers, scheduled jobs, UI modifications, versions, run history and settings) are in Forge hosted storage. A reinstall doesn't bring them back on its own: it starts a new, empty installation. If you reinstall within 21 days, contact us through the support portal, and with your consent we can ask Atlassian to restore them. After 28 days, Atlassian deletes them.
  • Scripted field code and workflow rules are saved in Jira's own configuration. They stay there, but nothing runs them while the app is uninstalled.
  • The Companion App is a separate app. Uninstall it the same way if you no longer need it. Connected apps lists it under the name you registered it with, for example script-master-companion-app, not under Script Master.
warning

Uninstalling starts the countdown to deletion for every script stored in Script Master. Export the items you want to keep first. See Import, export and duplicate.