Tools
Tools are no-code bulk operations that you run from the Script Master Tools page in Jira or Confluence. Each tool shows you what it will change before it writes anything.
Applies to: Script Master for Jira and Script Master for Confluence Β· Cloud
You open the page from Apps > Script Master Tools in the left sidebar. In Confluence, it's listed under Your apps. It lists the tools an admin has made available to you. Admins set that per tool on the Tools tab in Script Master: see Set who can use each tool.
Jira toolsβ
Script Master for Jira has two tools.
| Tool | What it does |
|---|---|
| Bulk Set Resolution | Sets or clears the resolution on work items selected by JQL. |
| Copy Custom Field Values | Copies values from one custom field to another on work items selected by JQL. |

Confluence toolsβ
Script Master for Confluence has seven tools. The two that delete data start out Disabled.
| Tool | What it does |
|---|---|
| Clone Space | Creates a space holding a copy of another space's page tree. |
| Replace Label | Swaps one label for another on pages, blog posts and attachments. |
| Add Label to Parent Pages | Labels every ancestor of a page. |
| Add Label to Child Pages | Labels every descendant of a page. |
| Insert Content into Pages | Adds a storage-format snippet to many page bodies. |
| Delete Attachments | Moves matching attachments to the space trash. |
| Delete Attachment Versions | Deletes old versions from attachment history. |

How a run worksβ
Every tool follows the same steps, so the screen reads alike whichever one you pick.
- Set it up. Choose what the run targets and what it changes. Confluence tools work on spaces, a page tree or a CQL query. Jira tools work on a JQL query.
- Check. Select the tool's check button, such as Check pages or Check work items. The tool reads and counts, and writes nothing.
- Review. Read the report. It says how many items matched, whether the run reached the 5,000-item cap, and anything that blocks it. Most tools also list the items.
- Run. Select the action button, such as Replace label. The tool works through the items one at a time and shows a counter. A summary replaces the form when the run ends.
If you change a search field after a check, the report goes away and you check again. That way a run never uses a stale list. Select Edit to change the form and keep your values, or Clear form to start over.
Tools run in your browser. Keep the tab open until the summary appears.
Before you run a toolβ
- Jira or Confluence permission: whatever the change itself needs. A tool runs as you, so it changes only what you could change by hand.
- App permission: the tool has to be available to you. See Set who can use each tool.
Relatedβ
- Set who can use each tool: who can see each tool, and what the setting doesn't do.
- Tools limits and behavior: the caps, retries and what a stopped run leaves behind.
- Troubleshooting Tools: fixes for the problems people hit most.