Myriastra Studio

User Guide — Progress Digest for Jira

For project teams · Updated 9 October 2026

Progress Digest turns a Jira project into an Excel workbook: how many work items are not started, in progress and done, what is past its due date, and what changed since the last report. You press one button; the workbook is attached to a work item in the same project, so it stays inside Jira.

You do not need to set anything up before your first report. Everything on the page below the Generate report button is optional.

The screenshots on this page come from a test project on a Jira site whose time zone is UTC, which is why they show Times are shown in Etc/UTC. Your site may show a different time zone.

1. How it works in one minute

  1. Open the project's Progress Digest page and press Generate report.
  2. The app reads the project's work items with your Jira permissions and builds a workbook.
  3. The workbook is attached to a work item in the project whose summary starts with [Progress Report]. The app creates that work item the first time and keeps using it.
  4. Each regular report also leaves a small record of the project at that moment. Later reports compare against a record, which is how the workbook can show what changed.
  5. Optionally, turn on a weekly schedule so a report is made for you and you are emailed when it is done.
  6. Optionally, use Report a past period to compare any two earlier records.

The app runs entirely on Atlassian's platform. Your data does not leave Atlassian, except for the weekly email, which Jira itself sends to the person who scheduled it. Details are in the Privacy and Security Policy.

2. Open the page

Open your project in Jira and look for Progress Digest among the project's apps. Where it appears is decided by Jira, not by the app: it may be a tab across the top of the project, or inside the Apps or More menu.

The first time you open it, Atlassian asks you to allow the app access. This is what lets the app read the project with your own permissions.

The page has four parts, top to bottom:

The Progress Digest page, with the four parts numbered: 1 Generate report, 2 Where reports are stored, 3 Scheduled report, 4 Report a past period.
The Progress Digest page. Only part 1 is needed. Select any screenshot to see it full size.
PartWhat it is forDo you need it?
1Generate report Makes a report now. Yes — this is the app.
2Where reports are stored Chooses which work item the workbooks are attached to. No. Leave it empty. See section 5.
3Scheduled report Makes a report every week at a time you choose, and emails you. Only if you want weekly reports without pressing the button. See section 6.
4Report a past period Compares two earlier records instead of "now vs. last time". Only after at least two reports. See section 7.

3. Generate a report

Press Generate report. The button shows Working… and a spinner with Generating the report appears next to it. While the page is waiting, the button cannot be pressed again. This can take a few minutes for a large project.

The Generate report button greyed out as Working…, with a spinner and the text Generating the report.
While the report is being made.

When the run is over, a message appears below:

A green message: Report generated. The report file has been attached to the work item that holds this project's reports. Open KAN-546.
The run is over. The link opens the work item that holds the workbook.

Open that work item and download the .xlsx attachment. The file name is the project key, _progress_ and a number, for example ABC_progress_1791462501758.xlsx.

A work item titled [Progress Report] IT Operations, with several KAN_progress_ .xlsx files under Attachments.
The work item that holds the reports, with the workbooks attached.

When you come back to the page later, it shows when the most recent report was made: The most recent report recorded for this project was generated 3 day(s) ago.

Your first report has nothing to compare with. The "change" column and the list of work items moved to Done on the cover are left blank, and the workbook says so in a note. Blank there does not mean zero. From then on, the comparison is filled in whenever there is an earlier record to compare with.

Old workbooks are tidied up. The app keeps the 12 most recent workbooks it attached for the project — regular and past-period reports together — and removes older ones, up to five per run. It only removes files it attached itself.

4. Reading the workbook

The workbook has four sheets.

SheetWhat is on it
Report Summary The cover: project, reporting period, when it was made, the key figures, the work items past their due date and the ones moved to Done, and a block of empty fields (Current issues, Risks, Countermeasures, Escalation, Other) for you to fill in before you send the file on.
Summary Figures Counts by status category — Not started, In progress, Done, and Status category not available — with the total and the change since the last report.
Period Changes What changed between the earlier record and this report, in five lists (below).
Details Every work item in the report: key, summary, type, status, assignee, created, due and updated dates.
The Report Summary sheet: project details, a Figures table with counts and change since last report, the work items past their due date, the work items moved to Done, and empty fields to be filled in by the reporter.
The cover sheet, Report Summary. The yellow fields at the bottom are for you to fill in.

The five lists on Period Changes

ListA work item is listed when…
Moved to Done its status category was Not started or In progress in the earlier record and is Done now.
Not in the previous record it is in this report but was not in the earlier record. This includes new work items, but also ones moved into the project or ones that have become visible to the person the report is for.
Due date changed its due date differs from the earlier record: Moved to a different date, Due date now set, or Due date no longer set.
Updated date unchanged it is still not done, its status category has not changed, and its updated date is the same UTC day as in the earlier record. Because only the day is compared, an update made later on that same UTC day does not take a work item off this list.
No longer in the list it was in the earlier record but is not in this report — for example it was moved to another project, deleted, or is no longer visible to the person the report is for. Only its ID and a link are shown, because the record does not keep summaries.
The Period Changes sheet with the five lists: Moved to Done 1, Not in the previous record 0, Due date changed 1, Updated date unchanged 562, No longer in the list 0.
The Period Changes sheet. Each list shows its count, then the work items in it.

The lists describe what was observed, not why. A work item can appear in more than one list. On your first report the five lists are empty, and a note on the sheet says this does not mean nothing changed.

Things worth knowing

5. Where reports are stored

You normally do not need this. On the first report, the app attaches the workbook to the oldest work item in the project whose summary starts with [Progress Report], or creates one if there is none. After that it remembers the work item it used and keeps using it.

Use this setting only if you want the workbooks on a work item you choose — for example an existing "Weekly status" work item your team already watches, or one with restricted visibility.

The Where reports are stored field left empty, and a green message: Setting saved. New reports for this project will be added to a work item that Progress Digest chooses or creates.
Saving with the field empty. New reports keep going to the work item the app last used.

Workbooks already attached stay where they are; only new reports go to a new place. The tidy-up in section 3 still counts them, so older ones are removed over time.

If the project has more than one work item whose summary starts with [Progress Report] when the app looks, the page says More than one reports holder and names the one it used (the oldest). This is not an error. Choose one here if you prefer a different one.

6. Scheduled report (weekly)

Turn on the switch under Scheduled report — its label is Generate a report every week — then choose a Day of the week and an Hour, and press Save schedule.

The Scheduled report part with the switch turned on, Day of the week Monday, Hour 10:00–10:59, the time zone line Times are shown in Etc/UTC, and the Save schedule button.
The switch is on and a day and hour are chosen. Nothing is scheduled until you press Save schedule.

You can still use Generate report at any time while a schedule is on. Section 4 explains what it compares against.

7. Report a past period

Every regular report — by hand or on a schedule — leaves a record: a small snapshot of the project's work items at that moment (status category, due date, assignee and updated day; no summaries). The app keeps the 52 most recent records per project. A past-period report itself does not add a record.

Press Report a past period to open this part, then:

  1. Choose From record (the earlier one) and To record (the later one). Each record is shown by the date and time it was made, newest first, in your site's time zone.
  2. Press Generate for this period. The run is the same as in section 3, and the workbook goes to the same work item.
The Report a past period part opened, with the From record and To record drop-downs and the Generate for this period button.
Choose two records, then press Generate for this period.

If you choose the same record twice, or a From that is later than To, the page says Select two different records: an earlier one for From and a later one for To. You need at least two records before this part can be used.

How a past-period workbook differs from a regular one

Regular reportPast-period report
Compares an earlier record → now From record → To record
Headings Change since last report, Moved to Done since last report, Past their due date Change over the selected period, Moved to Done during the selected period, Past their due date as at the end of the period
Note on the cover — This report compares two recorded points in time. …
Status column the status name, such as In Review the status category — Not started, In progress, Done, or Status category not available — because the record keeps only the category
Updated column date and time date only, because the record keeps only the day
Assignee column Assignee Assignee (current) — read from Jira now, because the record does not keep names
Key, summary, type, created read from Jira read from Jira now; blank for a work item that can no longer be read, and the cover says how many

The file name has the same form as a regular report. To tell them apart, open the cover: a past-period report has the note above and the period headings.

8. When something looks wrong

You seeWhat it means and what to do
Another run is already in progress A report for this project is already being made (perhaps by someone else, or by the schedule). Nothing was started. Try again once it finishes.
Report not generated — Progress Digest could not confirm a Jira permission it needs for this project: … Either your account does not have the named permission in this project, or Jira could not be reached to check. Try again. If it fails the same way, ask your Jira administrator for that permission (section 9).
Report not generated — This project is not visible to your Jira account … You cannot browse this project, so no report was made.
Report not generated — This run was declined. Try again later.
Report not stored The work item that holds the reports could not be used. If it is one you chose in section 5, the message names it and says what to do — choose another, or ask your Jira administrator to let the app see it.
Run did not complete The run stopped partway. It may be retried automatically. Come back later and check whether a report appeared. If none did, generate again — but the first one may still arrive, leaving you with two.
Report attached, but the run did not finish The workbook was attached. Do not generate again; you would get a second copy. The page's "most recent report" line may still show an earlier date.
Still running or Status not available The page stopped waiting, but the run may still be going. Do not press Generate report straight away. Reload the page later and check whether a report appeared.
Subscription required The app needs an active subscription on this site. No reports are made, by hand or scheduled, until then. Settings and the schedule can still be opened and changed.

9. Permissions

To do thisYou need, in the project
Generate a report, change where reports are stored, turn on a schedule that is off Browse projects
Let the app create the [Progress Report] work item the first time Create work items
Attach the workbook Create attachments
Change a schedule that someone else turned on Administer projects

For a scheduled report, these are checked for the person the schedule belongs to. The app never edits the fields or comments of your work items. Its only changes are creating the report work item, attaching workbooks, removing its own older workbooks, and sending the weekly email through Jira.

10. Getting help

Write to contact@myriastrastudio.com, or use the support page. If you can, include the project key and the message the page showed. Please do not send the workbook or work item contents.