"jiraPieChart" Macro
Last modified by Vincent Massol on 2026/08/04 21:49
Reference
Description
Displays a pie chart of how a set of JIRA issues is distributed over one field, using the statistics JIRA computes itself. The issues are selected by a JQL query or by the id of a filter saved in JIRA.
The Macro always starts a new block: it cannot be used inline.
Usage
The Macro has no content: everything is passed as parameters. Either id or url must be set to designate the JIRA instance, and either query or filterId to designate the issues. type is always mandatory.
{{jiraPieChart id="..." url="..." type="..." query="..." filterId="..." maxData="..."/}}Parameters
| Name | Mandatory | Allowed Values | Default Value | Description |
|---|---|---|---|---|
| type | Yes | STATUS, FIX_VERSION, ASSIGNEE, PRIORITY, COMPONENT, ISSUE_TYPE | N/A | The field the issues are distributed over, that is, what each slice of the pie counts. |
| id | id or url | An instance id defined in the wiki administration | N/A | The JIRA instance to query. Recommended over url, because the URL is then defined in a single place and the instance can authenticate. |
| url | id or url | A JIRA instance URL | N/A | The JIRA instance to query, given directly by its URL. |
| query | query or filterId | A JQL query | N/A | The query selecting the issues to chart. Ignored when filterId is set. |
| filterId | query or filterId | The id of a filter saved in JIRA, with or without the filter- prefix | N/A | The saved JIRA filter selecting the issues to chart. Takes precedence over query. |
| maxData | No | A positive number | 10 | The highest number of slices to display. Values beyond that count are displayed aggregated into one slice rather than dropped. |
Examples
Charting the issues of a project by status
{{jiraPieChart type="STATUS" url="https://jira.xwiki.org" query="project=XWIKI"/}}
Limiting the number of slices
{{jiraPieChart type="STATUS" url="https://jira.xwiki.org" query="project=XWIKI" maxData="3"/}}Charting a saved filter by assignee
{{jiraPieChart type="ASSIGNEE" id="xwikiorg" filterId="16802"/}}
Setting the parameters in the WYSIWYG editor
FAQ
Why does one slice hold several values?
Because more values were returned than maxData allows: the surplus is aggregated into a single slice instead of being dropped.
Can I chart on a custom JIRA field?
No. The type parameter accepts only the fields JIRA computes pie statistics over.
