For Jira admins, project leads, assignees and PMs · Updated 29 October 2026
NudgeRoll asks the assignees of open Jira work items, by email, whether their work is ready for the release it is planned for. Each person answers with one press, such as Ready for review or Change due date, and NudgeRoll applies the answer to the work item in Jira as that person. Project leads see the answers on a board, and PMs see a view per version with a history for each work item and an .xlsx export.
NudgeRoll does not decide whether work is finished. A project lead or the reviewer confirms each work item that is marked ready for review.
NudgeRoll has these screens:
| Screen | Who uses it | How to open it |
|---|---|---|
| NudgeRoll administration page | Jira admins | Settings (the gear icon), then Marketplace apps, then NudgeRoll under Apps on the left |
| NudgeRoll project settings | Project admins | In the project: … next to the project name, then Space settings, then NudgeRoll under Apps on the left |
| NudgeRoll email format | Each person, for their own email | Settings (the gear icon), then General settings under Personal Jira settings, then NudgeRoll email format under Apps on the left; or the link at the end of a Full list email, which opens a NudgeRoll page with Use this format |
| NudgeRoll answer | The people asked in the email | A button in the email |
| NudgeRoll board | Project leads and reviewers | The link Open the {project} board in a project lead's email |
| NudgeRoll PM view | Anyone who can browse a target project | The link Open the PM view for {project} in a project lead's email, or Open PM view in a PM's email |
The answer page, the board and the PM view do not appear in Jira's menus. Open them from the links in the email, and bookmark the board or the PM view if you use them often.
You need to be a Jira admin.
Europe/London or Asia/Tokyo.Press Save before Start sending. Nothing is sent until the settings are saved and sending has started. Start sending is recorded once, and the button is unavailable after you press it. When you open the page again later, it does not show whether sending has started, and the Start sending button can be pressed again. If sending has started, pressing it shows "Already started on …" with the original date; if it has not, pressing it starts sending.
You need to be an admin of the project. A project is not emailed until its status mapping is saved.
Open the project. Next to the project name, select … and choose Space settings. In the menu on the left, open Apps and select NudgeRoll.
Status mapping (default). Choose the statuses of the project for each of three groups:
| Group | What it means | Used when someone answers |
|---|---|---|
| Working | The work is in progress | Send back moves the work item to the first status listed for this group |
| In review | The work is ready for someone to check | Ready for review moves the work item to the first status listed for this group |
| Done | The work is finished | Confirm done moves the work item to the first status listed for this group |
Each group needs at least one status. A status in Working cannot also be in another group. In review and Done can share a status, for a workflow that has only a done status; then Ready for review already makes the work item done, and Confirm done only records the check.
The default mapping is used for work item types that have no setting of their own. Below it, you can set a different mapping for a work item type. The work item types are listed by name, such as Work item type: Task.
Below the mappings, NudgeRoll checks the project's workflow against a few existing work items, when the page opens and after Save. If an answer has no direct transition from a status, a warning names the work item type and the two statuses, and says that the button may not be applied. A line such as "28 combinations could not be checked (no work item in that status, or it could not be read)" means there was no work item to look at for those statuses; it is not an error.
Project leads and PMs. The Jira project lead receives the project lead's email. To add more project leads, find people by name with Search people and choose them under Additional project leads. Choose the PMs of the project under PM. If no PM is chosen, no PM email is sent.
Other.
Press Save. You see "Saved".
Copy to other projects. At the end of the project settings, Copy to other projects copies this project's saved settings to other projects: the status mapping with its settings for each work item type, the reviewer field and the days. The project leads and PMs of each project you copy to are kept. If you changed the status mapping, the reviewer field or the days and have not saved them, the page says "You changed the settings above. Save them first — Copy uses the saved settings." and you cannot copy until you press Save.
Statuses are matched by name and by status category (To Do, In Progress, Done). A project that does not have a status of the mapping, or has it with a different category, is not changed, and its line names the status, such as "Status "In Review" is not in this project". If this project has settings for single work item types, a project without the same work item types is not changed either (team-managed projects have their own work item types). Lines that end with "you can retry", such as "Could not save — you can retry", and the line "The result is unknown — reopen this page to check" can be tried again with Retry with the same settings. Lines that give another reason, such as a missing status, are not retried; fix the cause and copy again.
Set up by pattern. Jira admins can set up many target projects at once on the administration page, under Set up by pattern. It uses the saved target projects; if you changed Target projects and have not saved, the page says "You changed the target projects. Save them first — this section uses the saved targets."
Projects whose statuses could not be read are listed under Could not read, with the reason. Set them up in their own project settings.
NudgeRoll sends one email a day at most to each person, through Jira's own notifications. The subject is "NudgeRoll: 3 items to check today", with the number of items. If there is nothing to ask a person, no email is sent.
Which work items are asked about. The open work items of the target projects, by the version in their Fix versions field:
Who gets which part. One person can hold several roles; they get one email with a part for each:
| Part | Who | What it holds |
|---|---|---|
| Assigned to you | The assignee of each work item | The work items to answer, with Ready for review, Still working, Change due date and Unassign |
| As project lead | Project leads | Work items that are unanswered, sent back, unassigned, with an assignee no longer active, not applied, whose email could not be sent, or ready for review. Each line has Confirm done and Send back, and the part has the link Open the {project} board |
| To review | The person in the reviewer field, unless they are also a project lead | Work items ready for review, with Confirm done |
| PM | PMs | For each version, the counts (total, done, open, needs a look, unanswered) and the open work items with their last answer, and Open PM view. The PM part has no answer buttons |
| Nothing left open | PMs | Once, when the last open work item of a version is done. If the project uses issue security, it says nothing left open among the work items you and the app can see. Not sent for work items with no fix version |
The number in the subject counts the work items, plus the PM versions and the versions with nothing left open.
In the parts for assignees, project leads and reviewers, each line of a work item gives its key, summary, status and due date (or No due date); a PM's lines give the key, summary, state and last answer. A line can carry a mark: Sent back, Assignee changed (with the previous answer when there was one), Could not be applied to Jira or May not have been applied — check the work item, the last two with a link Open work item.
Each email lists only work items that both the app and you can view. A list shows up to 100 work items; the rest are counted, and the email says "Only the first 100 items are listed. Check the rest in Jira."
The Status line shows the status when the page opened. After Submit goes through, it shows the status of the work item again. If NudgeRoll cannot read it then, the line says Status when opened instead.
The first time you open a NudgeRoll screen, Atlassian may ask you to allow the app to access Jira on your behalf. Allow it to continue. The app uses that access to show work items with your own permissions and to apply your answers as you. On that first visit, the answer can take two presses: the permission, then Submit.
What each answer does:
| Button | Who can use it | What happens in Jira |
|---|---|---|
| Ready for review | The assignee or a project lead | Moves the work item to the first status of the In review group |
| Still working | The assignee or a project lead | Nothing changes in Jira. NudgeRoll records the answer, and the work item no longer counts as not updated |
| Change due date | The assignee or a project lead | Sets the work item's due date |
| Unassign | The assignee or a project lead | Removes the assignee. The project lead then sees the work item as unassigned |
| Confirm done | The reviewer or a project lead | Moves the work item to the first status of the Done group |
| Send back | A project lead | Moves the work item to the first status of the Working group. The assignee sees Sent back in the next email |
After Submit, the page shows one of these:
NudgeRoll reads the work item again when the page opens and when you press Submit, and treats Jira's current value as correct. It uses only a direct transition from the current status; if the workflow has none, the page says "Could not be applied to Jira". If the page says "This project is waiting for setup", the project's status mapping has not been saved yet.
Project leads open the board with Open the {project} board in their email. A reviewer who is not a project lead sees only the work items they are asked to check; their email has no board link, so they open the board from its address, for example one a project lead shares.
The board lists the open work items of the project that NudgeRoll has asked about or that need action, in five sections, each with a count:
Each work item is a card with its key and summary, its status, assignee, due date, reviewer and versions, and marks such as Sent back, Assignee changed, Self-review (the assignee is also the reviewer, or, when the reviewer field is empty, a project lead) or May not have been applied — check the work item. The top of the board can show PM not set, Status mapping needed, Version has no date or Past release date.
Each section shows its first 10 work items. Press Show 20 more (35 remaining) to see more; when fewer than 20 are left, the button shows that number. The count in the section heading is the full number, including the work items not shown yet.
Press an action on a card. The action opens in a window in front of the board, wherever the card is, with the work item key and the action as its title. It shows "Loading…" for a few seconds before Submit can be pressed. Check it, and press Submit, or Cancel (or Esc) to go back. After Submit, the window shows the result, such as "Applied to Jira", and the board behind it reloads; press Close to close the window (if Submit was refused, for example because the action is not allowed, the button still says Cancel). The board lists only open work items, so a work item you confirm as done leaves the board instead of moving to another section. The actions of a project lead depend on the section:
| Section | Actions |
|---|---|
| Awaiting review | Confirm done, Send back, Change assignee |
| Unanswered | Ready for review, Still working, Change due date, Unassign, Change assignee |
| Needs action | Change assignee, Ready for review, Change due date |
| Not applied, not confirmed, or delivery failed | Ready for review, Still working, Change due date, Change assignee |
| Answered | Ready for review, Change due date, Change assignee |
Change assignee is only on the board: find a person by name with Search people and choose the Assignee. A reviewer has Confirm done only, on work items awaiting review.
Several work items at once. Cards with Confirm done, Change assignee or Change due date have a check box. You can select up to 20 work items, all in one section. When 20 are selected, the other check boxes become unavailable and the board says "You can select up to 20 at a time." Selecting a card in another section starts a new selection there. Select all shown (up to 20), at the top and the bottom of each section that has a card with a check box, selects the cards that are shown. The board then shows how many are selected, Clear selection, and a button for each of those three actions that all the selected work items have. They appear next to Select all shown (up to 20), at the top and the bottom of the section, not next to the card you selected.
Anyone who can browse a target project can open its PM view, from Open the PM view for {project} in a project lead's email or Open PM view in a PM's email. These links are only in Full list emails. The view counts and lists only the work items you can see.
Export. At the bottom of the view, under Export, press Export xlsx. The file nudgeroll-pm-<project key>-<version ID>-<date>.xlsx has two sheets:
The export holds only each work item's last answer. The full history stays in the app's log and is shown with Show history.
If the version has more work items than one view or export can hold, the screen says it shows a partial list, and how many work items could not be shown. If the file would be too large, the screen says "The file is too large (limit: 3 MB)".
Each person chooses the format of their own email:
There are two ways to switch:
The log of a work item is kept for two years after its last entry, and is then deleted as a whole. There is no setting to change this period.
When the app is uninstalled, it stops, and its log and settings are no longer used. According to Atlassian's Forge documentation, the app's storage is then kept for 28 days and afterwards handled under Atlassian's own retention and disposal policy, so the data is not erased the instant you uninstall. The .xlsx export holds only the last answer for each work item, not the full answer log, so export before uninstalling if you need it. The administration page and the PM view show this notice: "If you uninstall the app, its answer log is deleted. The xlsx export holds only the last answer for each work item, so export first if you need that." The notice is short; the deletion follows the timing described above. What the app reads, writes and stores is described in the Privacy and Security Policy.
To stop emails for a project, a Jira admin removes it from Target projects on the administration page and presses Save. At least one target project is needed. The project's answer page, board and PM view then stop working too, and say "This project is not one of the target projects". An email that Jira asked the app to retry can still go out in the next hourly run. This version has no setting to pause sending for the whole site; to stop it, uninstall the app, after exporting what you need.
If the app's license for your site is inactive, no email is sent and changes made outside NudgeRoll are not collected. The screens and the export still open, but answers and settings are paused: an action that would change something, such as Submit, Save or Start sending, shows "The NudgeRoll license for this site is inactive, so answers and settings are paused. Ask your site admin to renew the license." Sending resumes after the license is active again. The deletion of expired log entries continues while the license is inactive.
Email contact@myriastrastudio.com. Please do not send an exported workbook or the summaries of your work items; describe what you see on the screen instead, with the work item key. What the app reads, writes and stores is described in the Privacy and Security Policy.