Aggregate by - select the field to group work items by. Options include Epic, Version/Release, Team, Assignee, Component, Label, Space, Work Item Type, Priority, Status, Reporter, Creator, and custom fields. Select "Individual Work Items" to show one bar per issue.
Date fields
Configure which date fields are used for the start and end of each task bar:
-
Start field - the date field used for the start of the bar (Created, Due Date, Resolved, Moved to Done, Sprint start, Sprint end, or custom date fields)
-
End field - the date field used for the end of the bar (same options as start field)
Sprint start and Sprint end are offered when your site has a Sprint field. For a work item in several sprints, the bar runs from the earliest sprint start to the latest sprint end; closed sprints use their actual completion date.
In aggregate mode, the bar spans from the earliest start date to the latest end date across all work items in the group.
Work items without a date value for the selected field do not affect the bar's position on the timeline. Not every work item in the group needs to have dates set — even a single work item with dates is enough to display the aggregate bar on the timeline.
Time scale
Select the granularity of the timeline: Auto (fit the date range), Days, Weeks, Months, Quarters, or Years (default Weeks). Auto picks the finest scale whose columns still fit their labels at the current gadget width. With a fixed scale, a warning is shown when columns are too narrow for the selected time scale.
Chart height (rows)
Configure the number of visible rows before a scrollbar appears (1-100, default 10).
Resolution and Status
With default settings, the gadget uses the resolution date to determine completion. Enable "Count work items with Done status as resolved" to include work items in a Done status category even without a resolution date.
Progress calculation
When aggregating by a field, progress can be calculated based on:
-
Work item count
-
Story points
Story Points field
Shown when progress is calculated by story points. The "Story points field" dropdown defaults to "Automatically detect", which uses the Story Points or Story point estimate field. If your Jira instance uses a different field for story points, select it from the list.
Sort rows by
Choose the order of rows on the timeline: Start date, End date (earliest or latest first), Name (A–Z or Z–A), or Progress (least or most done first). The default is Start date (earliest first).
JQL filter
Data supplied to the app can be filtered using JQL filters, with the gadget supplying some JQL presets including: work items in space, work items in Epic, work items in version, work items in active sprints, custom JQL, and saved Jira JQL filters.
When about 10,000 or more work items match your JQL, a hint below the JQL field notes that loading may take a little longer; a narrower query loads faster.
If you are running Jira Cloud and want to use Adaptavist ScriptRunner JQL functions you should save them and use them as synchronized filters instead via JQL - filter = "enter name or id of the filter"
Import/Export Configuration
Use the "Import/Export Configuration" menu at the bottom of the gadget settings to copy the configuration with "Export to Clipboard" or apply a copied configuration with "Import from Clipboard". This is useful for duplicating gadgets or transferring settings between dashboards.