🛠️ Administrator’s Guide – Issue Delivery Report

📦 Installation

Issue Delivery Report is a Forge-based Jira Cloud app that installs seamlessly across all issue types.

To install:

Go to Apps → Find new apps
Search for Issue Delivery Report
Click Try it free
Approve the required permissions

The app will automatically appear in the issue view panel of every issue in your Jira instance.

🔐 Permissions

Upon installation, the app requests the following minimal scopes:

read:jira-work – to fetch issue data and changelogs
read:jira-user – to display the names of users who made status changes
storage:app – (optional) for future extension (no data is persisted now)

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

⚠️ Note: This app does not write to Jira or modify any issue data. All data processing is read-only, except when exporting.

🧩 Configuration

No setup is required. The app works automatically on every issue.

As an admin, you may:

Restrict visibility of the app panel via project-level issue layout configuration
Share the status naming guidelines with your team
Encourage consistent naming for accurate metric calculation

🔄 Updates

Issue Delivery Report is updated automatically via Atlassian Forge.
No manual updates are needed.

👥 Who Should Use It?

This tool is ideal for:

Scrum Masters – to evaluate blocked or waiting issues
Product Managers – to review delivery timelines and sprint scope
Engineering Managers – to track bottlenecks and efficiency
QA Leads – to understand blocked cycles or delayed testing
Anyone analyzing delivery health of individual issues

🧪 Testing Before Production

You can safely install the app in a sandbox environment or test project.
Try it on a few issues to verify status naming conventions and metric accuracy before using it across teams.

🧼 Uninstalling

To remove Issue Delivery Report:

Go to Apps → Manage Apps
Find Issue Delivery Report
Click Uninstall

📝 This will not remove any exported data or browser-stored reports.
Since the app doesn’t save data in Jira properties, no cleanup is required after removal.

🧠 Admin Tips

✔ Educate your team about status naming for accurate reporting
✔ Encourage export usage for retrospectives or external tracking
✔ Use the “Sprint Addition” indicator to enforce scope discipline
✔ Share Flow Efficiency insights to drive continuous improvement