Display JIRA Issues in a Page
Steps
The jira Macro displays a set of JIRA issues in a page, as a table, a bulleted list or an enumeration. You need the id an administrator gave the JIRA instance, or its URL, as described in Configure a JIRA Server. The complete parameter list and rendered examples are in "jira" Macro.
- Edit the page and insert a jira Macro where the issues should appear.
Set the id parameter to the instance id, or the url parameter to the instance URL.
- Write one issue key per line in the Macro content to display exactly those issues, or set source to jql and write a JQL query in the Macro content instead.
- Set style to list or enum to display the issues as a bulleted list or as an enumeration, or leave it out to get a table.
- Set fields to the comma-separated ids of the issue fields to display, in the order you want them, or leave it out to get the default fields of the chosen style.
- Set maxCount to the highest number of issues you want displayed, or leave it out to let JIRA decide.
- Save the page. The issues JIRA returns are displayed in the style you chose.
FAQ
Can I add my own note next to an issue?
Yes, when you list the issue keys yourself: separate the key from the note with a pipe character, and add the note field to the fields parameter.
Can the issues be displayed inside a sentence?
Only with the enum style, as the style parameter of "jira" Macro states.
Where do I find the ids of the fields I can display?
In JIRA Issue Fields, which also covers custom JIRA fields and how to relabel a field.
The Macro shows an error instead of my issues. What went wrong?
Either JIRA rejected the query, or the account the wiki uses is not allowed to read one of the issues. See JIRA Connection Errors.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
