🛠️ Administrator’s Guide

Configure with confidence. Empower your teams.

📦 Installation

Flow Time Report is a Forge-based app available for Jira Cloud. To install it:

1. Go to Apps → Find new apps

2. Search for Flow Time Report

3. Click Try it free

4. Grant the required permissions

The app will be available in the issue panel of every issue type across all projects.

🔐 Permissions

Upon installation, the app requests the following minimal scopes:

• read:jira-work – to read issue details and status fields

• write:jira-work – to save badge selections using issue properties

• read:jira-user – to display user names in the changelog

• storage:app – (optional) for storing app-level settings or future extensions

✅ Make sure these scopes are approved in your site’s admin settings to ensure full functionality.

🧩 Configuration

No setup is required.
However, as an admin, you can:

• Limit usage to certain issue types via project settings

• Educate your team on how to assign badge values for better tracking

• Export history for reporting or external tools

🔄 Updates

Flow Time Report updates automatically via Atlassian Forge.
No action is needed from your side.

👥 Who Should Use It?

This tool is most useful for:

• Scrum Masters

• Product Managers

• Engineering Managers

• QA Leads

• Anyone managing flow efficiency and cycle time

🧪 Want to test it first?

We recommend installing in a sandbox or a test project and validating with test issues before scaling to production use.

🧼 Uninstalling

To remove Flow Time Report:

1. Go to Manage Apps

2. Search Flow Time Report

3. Click Uninstall

Note: This does not delete issue properties saved (e.g., badges).
You can manually remove these via the REST API if needed.

🧠 Admin Tips

✔ Use badge metadata to flag risks during sprints
✔ Encourage teams to review Flow Time during retros
✔ Export data for BI dashboards via CSV or JSON