How to modify the columns in the Jira issues macro


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 ( 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

9 answers

1 accepted

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.

There is also an issue that concerns the disconnect between the two jira issue macro styles:

Have you tried editing the macro in the macro browser (in Confluence)? It should display a box for you to enter the column names.

There is also an issue that concerns the disconnect between the two jira issue macro styles:

There is also an issue that concerns the disconnect between the two jira issue macro styles:


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 |

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, 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}

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

1. {jira:url=|columns=key}

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

2. {jira:url=|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

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.

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

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:


And it works ;-)

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



Suggest an answer

Log in or Sign up to answer
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Kesha Thillainayagam
Posted Apr 13, 2018 in Confluence

We want to hear how your non-technical teams are using Confluence!

Hi Community! Kesha (kay-sha) from the Confluence marketing team here! Can you share stories with us on how your non-technical (think Marketing, Sales, HR, legal, etc.) teams are using Confluen...

2,916 views 27 12
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you