How to modify the columns in the Jira issues macro
Asked by Tim Brown:

Hi,

We want to display issues from our Jira v5.0.5 system on a page in Confluence using the Jira issues macro.

We are getting a list of issues using JQL \& the resulting table displays on the page.

However I want to only show a subset of the columns from the standard Jira issues table.

The doco (<https://confluence.atlassian.com/display/DOC/JIRA+Issues+Macro>) advises that the macro takes parameters to control the columns displayed but I we dont have parameters for this in the macro in Confluence v4.2.4


Answers:
author: Mark Hrynczak
body: There are actually 2 different JIRA Issues macros available for use in Confluence. Which one you are using depends on which parameters you give it.

That is, you can **either**:

* Use {jira:\<some_jql_statement\>}
* Use {jira:url=xxx,columns=yyy,title=zzz}

In the first of these you can use any jql you like, but there are no other parameters or config options available.

In the second, you have access to all of the standard parameters, but it does not take JQL, you need to use the compulsory 'url' parameter which takes the XML link of the search you want to use.

If you want to control the columns which are displayed, you will need to use the second one, passing in a 'url' parameter. To get this URL:

1. Go to your JIRA instance, and do the JQL search
2. Open the 'Views' menu and copy the link for the 'XML' item

In Confluence you can now enter the macro and and edit the parameters as you want.

This is described in more detail [here](http://confluence.atlassian.com/display/DOC/JIRA+Issues+Macro#JIRAIssuesMacro-DisplayingaListofJIRAIssuesfromanyAccessibleJIRASite).


author: Don Willis
body: There is also an issue that concerns the disconnect between the two jira issue macro styles: <https://jira.atlassian.com/browse/CONF-23275>


author: Matthias Born
body: There seems to be a hidden feature for the issues macro:

I stealed the columns parameter from die "jiraissues"-macro (xml editor plugin) and added it to the issue-macro:

`<``ac:parameter``ac:name``=``"columns"``>Key,Summary,Assignee,Status</``ac:parameter``>`

And it works ;-)

Perhaps you can create a user-macro as an wrapper arround the issue-macro.

Regards!

Matze


author: Peter Neelmeyer
body: Would like to ask community if somebody got something like this working as a link to a single issue:

1. {jira:url=https://jira.atlassian.com/browse/JRA-1827\|columns=key}

This one should be wrong as "title" is only needed, if we have a list:

2. {jira:url=https://jira.atlassian.com/browse/JRA-1827\|columns=key\|title=Allow users to use JIRA without cookies}

I use Confluence 4.3.1 and only {jira:\<ISSUE-ID\>} is working for single links but it is always showing also the title of the issue and its status.

With url-Parameter to a single issue like 1. it complains about: Error on line 125: The element type "link" must be terminated by the matching end-tag "\</link\>".\<br/\>class java.io.IOException

and it shows a list with no issues

Additionally only {jira:\<ISSUE-ID\>} and {jiraissues:url=...} can be edited afterwards via context menu and overlay dialogs.

<br />

Unfortunately I could not find a documentation yet of these jira-parameters, only jiraissues seems to be documented with url-/columns-Parameter (?)


author: Mark Hrynczak
body: I agree it is confusing. There are 2 macros. One can show **either** a single issue, or a list of issues. The other, older macro can only show a list of issues, but has more display options available as parameters.

If this is still not clear to you, try raising a [support request](https://support.atlassian.com), and we can go into more detail, maybe with a screenshare.

You are correct that parameters are separated by \|. My comment above should have read:
> * Use {jira:url=xxx\|columns=yyy\|title=zzz}


author: Peter Neelmeyer
body: @Mark

I am confused. The second one seems to be the same like jiraissues - which is a list, not a single link.

Normally the parameters are separated by \|

<br />


author: Don Willis
body: There is also an issue that concerns the disconnect between the two jira issue macro styles: https://jira.atlassian.com/browse/CONF-23275


author: Don Willis
body: There is also an issue that concerns the disconnect between the two jira issue macro styles: https://jira.atlassian.com/browse/CONF-23275


author: Azwandi Mohd Aris
body: Have you tried editing the macro in the macro browser (in Confluence)? It should display a box for you to enter the column names.