Browse documentation

FAQ

Questions people ask before installing, and the ones security reviews always ask.

Safety

Can this app break my Jira?
It can delete schemes, merge fields and change ownership, because that is what you are asking it to do. It never acts without a review step and an explicit selection. Use a test site for the destructive tools, and start with the smallest scope.
Does anything run automatically?
No tool does. Nothing scans, deletes, merges or transfers unless you click it. There is exactly one scheduled job in the app and it touches nothing in your Jira: once a day it reports the account IDs it holds to Atlassian, so a closed account can be erased from its records.
Can I undo a cleanup?
Depends on the tool. Archiving projects and moving fields to trash are reversible. Deleting a scheme is not. The guides mark which is which.
Does data leave Atlassian?
No. The app runs on Atlassian Forge and declares no external network access at all — there is no allowed-host list in its manifest for anything to be sent to. The CSVs and PDFs are built in your browser.
Does it use AI?
No. Every tool is deterministic: it reads your configuration and reports facts.

Permissions

Why does it need such broad permissions?
Because the tools work across the whole site: all projects, all fields, all schemes. A tool that could only see one project could not tell you that a scheme is unused. Each scope is explained on the reference page.
Can a project administrator use it?
No. The tools are on a global admin page and require Jira administrator rights.
Why did my group change fail?
Atlassian only allows site administrators to change group membership. The tool reports this clearly instead of failing silently.
Does User Analysis need an API key?
No. You upload the CSV exports from admin.atlassian.com. If you want live licence data and automated action, use License Waste Manager instead.

Practical

Where do I start if my instance is a mess?
Project Activity, then Custom Fields Health Assessment. Both are read-only, and together they tell you what matters and what is dead.
Does it work with team-managed projects?
They appear in Projects Manager and Project Activity. The configuration cleanup tools work on company-managed configuration, because team-managed projects keep their settings to themselves.
Will the field merger lose data?
The values are moved by a Jira CSV import that you review and run, and source fields go to trash rather than being deleted. Test on a non-production site first.
Can I export the results?
Yes, and from more tools than you might expect. CSV from Project Activity, Custom Fields Health Assessment, Workflow Health, Scheme Deduplication, Filter Management, the Custom Field Merger and every User Analysis drill-down. PDF from the Custom Fields Health Assessment — that is the only one. Exports are generated in your browser, so they keep working even without an app licence.
What can I still do if the licence lapses?
Read every result you already have, export it, search for users and projects, and reset a stuck tool. What stops is starting a scan and writing to Jira. User Analysis works in full, because it never calls the backend at all.
What happens when I uninstall?
The app runs an uninstall handler that empties its storage before it goes — sweeping repeatedly until a pass finds nothing — and independently Atlassian detaches the installation's data and destroys it under its own retention policy. See Where your data goes. Changes the tools already made to your Jira configuration stay, because they are now part of Jira.

Something missing or wrong on this page? Tell us in the support portal or email contact@synapseoasis.com.