Sections

Sections, like pieces of a puzzle, fits together to form a clear picture of your project’s current state—helping you review and adapt your delivery plan. Each report is made up of multiple customizable primary and pop-up sections, which are detailed in the following article.

Primary sections

A report consists of six primary sections, five of which are shown in the screenshot above.

1. Header: Set the report’s description, sharing permissions, and configurations, and export its contents.

2. Tabs: Navigate between different configured report views.

3. Slices: Use JQL to filter the report and display custom indicators.

4. Progress: Display indicators to monitor Status, Completion, and other metrics.

5. Summary: Group and tabulate the report’s contents and explore indicators further.

Each section consists several interactable elements, which are detailed as follows.

Header

The Header section lets you share the report with internal users or export it for external users. It also provides quick access to your reports, linked pages or notes, and the report's configuration settings.

The following elements are available in the Header section and can be used to perform these actions:

1. Name: Displays the report name. Select the down arrowhead (⌄) to access a list of your most frequently used reports.

2. Sharing type: Displays a color-coded icon and text indicating the report's access permissions. In the screenshot above, a green square labeled Public is displayed.
   Select the text to open the Sharing Settings pop-up.

3. Favorite: Select the star icon to mark the report as a favorite, making it easier to find among your reports.

4. Description: Displays the report description as plain text or as a hyperlink to an external webpage.

5. Excel: Exports the report to a Microsoft Excel workbook.

6. Export options: Select the arrowhead (⌄) to open a dropdown menu with additional export options, including HTML, PDF, and Confluence.

7. Share: Copies the report URL to your clipboard.

Other buttons:

• Save a copy: Store a duplicate version of the report, which you can edit.

• Configure: Access the report sidebar, which allows you to configure the current report tab.

Tabs

The Tabs section works similarly to sheets in a Microsoft Excel workbook. It allows you to focus on different aspects of your Jira data while using the same report source. For more information about this section, refer to the related article.

For example, you can compare how one field affects another, track leading or lagging indicators using Warnings, and more.

Slices

This section allows you to filter the contents of the entire report by selecting one Slice at a time. A Slice can also be used to display a numerical value or a time-based metric. To learn more about this section, refer to the related article.

In the example below, a Slice shows that there are 4 issues` in the To Do status category.

Progress

The Progress section helps you track completed and remaining work. It offers a variety of indicators, such as Completion Rate, Completion by Time, Story Points, and custom fields, allowing you to choose the metric that best fits your reporting needs. To learn more about this section, refer to the related article.

In the example below, the progress indicator shows that 7 of 12 story points have been completed. In other words, issues in the Done status category have a combined total of 7 story points.

Summary

The Summary section helps you categorize the contents of the report source in a table format. Its layout changes depending on the active tab, and you can configure its rows, columns, and groupings.

Breakdown

The Breakdown section provides a detailed view of the data summarized in the Summary section. It allows you to enable additional columns that support Jira system fields, app fields, and custom fields.

Pop-up sections

When users interact with the report's primary sections—for example, by clicking an element in a progress indicator—secondary sections or pop-ups appear to provide additional context without taking them away from the main report.

Each report includes two types of pop-up sections.

Breakdown Pop-up

The Breakdown Pop-up shows a condensed view of report data, letting you explore the details of each Jira issue without leaving the report. This pop-up is disabled for the Issue Structure tab, since its Summary section already contain the contents of the Breakdown section.

Summary section

You can open a Breakdown Pop-up from the Summary section by clicking elements in the Pivot, Worklogs, Capacity, or Warnings tab types.

As shown in the below screenshot, you can navigate to this element at the intersection of a row subtotal and a column grouping.

Progress indicators

You can open a Breakdown Pop-up from the Progress section by clicking on an element belonging to a progress indicator —like a label, colored bar, or value, as shown in the below screenshot.

1. Label: The count of Issues To Do appears in this label.

Clicking on this element will open a Breakdown pop-up showing all 4 issues.

2. Value: This value corresponds to the total amount of issues considered by the progress indicator.

Clicking on this element will open a pop-up showing all 25 issues regardless of their status category.

3. Colored bar: This bar is linked to the count of Issues To Do.

Clicking on this element will open a pop-up showing all 4 issues, as shown in this example.

By clicking on on the label or the colored bar, 4 issues left To Do will appear within the Breakdown Pop-up.

Chart

You can open a Breakdown Pop-up from the Charts tab by clicking on an element belonging to a chart —like a label, colored bar, or value, as shown in the below screenshot.

1. Colored bar: This bar represents the number of work items that are currently In Progress.

Hovering over the grey bar displays a tooltip showing the label and value associated with the bar.

Clicking the grey bar opens a Breakdown pop-up containing all 4 issues represented by the bar.

2. Label: The label displays the number of work items that are currently In Progress.

Clicking the label opens a Breakdown pop-up containing all 10 issues in this category.

3. Value: This value represents the total number of work items included in the chart.

Clicking the value opens a Breakdown pop-up containing all 25 issues, as shown in the screenshot below.

Edit Issue Pop-up

The Edit Issue pop-up window displays the Jira issue view for the selected issue, allowing you to view and edit it without leaving the report.

You can open it from the Summary section of the Issue Structure tab or from the Breakdown pop-up by following steps below.

Access using the Issue Structure tab’s Summary

By using the Summary section of the Issue Structure tab, you can directly read or edit an issue by following these steps.

1. Navigate to the Issue Structure tab and hover over the row of the issue you want to modify.
   A pencil icon will appear.
   Click this icon to open a pop-up where you can view and edit the Project Bravo Bug, as shown in the screenshot below.

2. In the Edit Issue pop-up, scroll down to find the field you want to update.
   You can also use the Configure Fields button to choose which system and custom fields appear in the pop-up.

3. Once the Issue is edited, click Update in the pop-up.

4. Click Reload report button to refresh the contents based on the edits you made.

Access using the Breakdown Pop-up

1. Navigate to the Summary section of any tab type, except the Issue Structure, open a Breakdown pop-up, and hover over the row containing the issue you want to modify.
   A pencil icon will appear. Click this icon to open a pop-up where you can view and edit the Project Bravo Bug, as shown in the screenshot below.

2. In the Edit Issue pop-up, scroll down to find the field you want to update. You can also use the Configure Fields button to choose which system and custom fields are shown in the pop-up.

3. Once the Issue is edited, click Update.

FAQ

Tabs

Slices

Progress indicators

Breakdown section

Pop-up section

Can you edit issues using the Issue View pop-up?

Yes. You can edit issues directly from the Issue View pop-up, as long as your user account has the required field edit permissions. These permissions are managed by your Jira administrator.

After editing an issue in the Issue View pop-up, the report will prompt you to save and reload your changes by clicking the ‘Reload report’ button, as shown in the screenshot.

This step is required because your edits have changed the report’s source data.

Troubleshooting

Breakdown section

Can you resolve an error that appears when using the Breakdown pop-up?

The error above may appear after clicking the issue count (left-hand side) or the Issue Navigator button (right-hand side) shown in the Breakdown pop-up.

This error typically occurs due to two conditions: when the project key contains more than two letters, and when more than 1,000 issues are displayed in the Breakdown pop-up.

For example, if 1,300 issues appear for the CSD project, an error may occur when attempting to open the Issue Navigator from the pop-up.

To resolve this error, reduce the number of issues displayed in the pop-up by using slices. For example, filter issues based on the status category.