Rollup Fields for Jira · Documentation · Support · Privacy · Security · Terms
Rollup Fields for Jira: Documentation
Rollup Fields adds a Jira custom field that shows a total (sum, count, minimum, maximum, average, or % done) over the subtasks, child issues or linked issues of an issue. This page explains the setup and gives a 10-minute test you can follow on any Jira Cloud site.
What you need
Jira Cloud, Jira administrator permission (the configuration page is admin only), and a project that has an Epic with a few child issues that carry a number field such as Story point estimate.
Set up
- Create the field. Jira settings > Issues > Custom fields > Create custom field > choose Rollup (for numbers) or Rollup (date) (for dates). Name it, for example,
Rollup Test. Add it to the screens of the project you will test in (the edit and view screens of the Epic issue type). - Configure it. Jira settings > Apps > Rollup fields. Press New rollup field (or Create one). Pick the field you created, set Collect from (all descendants, subtasks, child issues or linked issues), set Calculation, pick the Source field (for example Story point estimate), optionally add a JQL filter, and press Save rollup. Saving recalculates all existing parent issues; the green message tells you how many were updated.
- Read the value. Open the parent issue. The rollup field shows the total. It updates by itself when a child is created, changed, deleted or linked.
Test guide (about 10 minutes)
- Create an Epic, for example
DEMO-1, in a company-managed or team-managed project. - Create three child issues of that Epic (Story or Task) and set Story point estimate to 3, 5 and 8.
- Create the field
Rollup Testas above and add it to the Epic's screen. - Open Jira settings > Apps > Rollup fields. Press New rollup field: field
Rollup Test, Collect from Child issues (one level), Calculation Sum, Source field Story point estimate. Press Save rollup. - Expected: a green message “Saved. Updated N of N parent issues.” and the Epic
DEMO-1showsRollup Test = 16. - Change one child to 10 points. Expected: the Epic shows 18 within a few seconds, without any action.
- On the same admin page, under Check a value, choose the saved rollup, type
DEMO-1and press Calculate. Expected: the value 18 and “from 3 issues”. - Try Count or % done in the same way: edit the rollup, change Calculation, save.
If you see no value
- The parent must have children of the chosen kind. A rollup over an issue with no children shows 0 (sum, count) or stays empty (minimum, maximum, average).
- The children must have a value in the chosen source field. Empty fields are skipped.
- The rollup field must be on the parent issue's screen, otherwise Jira cannot store the value; the save message then lists the issues that failed.
- The Collect from choice must match your structure: Epic children use Child issues or All descendants; subtasks use Subtasks.
- Check a JQL filter you entered: it narrows the issues that count.
Video
A walkthrough of the same flow: youtu.be/F47OFaxGyrM.
Limits
Up to 1,000 source issues per calculation; descendants are read up to 5 levels below the issue. Time fields are shown in hours.
Help
Write to security@zenthas.com, see Support.