"jiraCount" Macro
Last modified by Vincent Massol on 2026/08/04 21:49
Reference
Description
Displays the number of JIRA issues matching a JQL query, and nothing else. Use it when the count is the information and the issues themselves are not.
The Macro can be used inline, inside a sentence.
Usage
The Macro content is always a JQL query. There is no parameter to choose what is displayed: the output is the number of matching issues.
{{jiraCount id="..." url="..."}}
...the JQL query selecting the issues to count...
{{/jiraCount}}Either id or url must be set; id is recommended, for the reasons given in JIRA administration.
Parameters
| Name | Mandatory | Allowed Values | Default Value | Description |
|---|---|---|---|---|
| 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. Takes precedence over id when both are set. |
Examples
Counting the issues of a project
Number of issues in the XWiki Platform project:
{{jiraCount url="https://jira.xwiki.org"}}
project = XWIKI
{{/jiraCount}}Counting issues inside a sentence
Or inline you can count this way: {{jiraCount id="xwikiorg"}}issueKey in (XWIKI-1000, XWIKI-1001){{/jiraCount}}
FAQ
Why is the number smaller than what JIRA shows me?
Because the wiki reaches JIRA with its own account, which may not be allowed to read every issue your own account can see.
Can I display the issues instead of the number?
Yes, with the jira Macro, which takes the same id and url parameters and the same JQL query.
