Jira Issues Macro does not create remote links from JQL tables (Data Center and Cloud)

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

When using Jira Issues Macro in Confluence to link to JQL results, the issues are not linked to the Confluence page.

Environment

Jira DC 8.x, 9.x

Confluence 7.x, 8.x

Diagnosis

Jira Issues Macro in Confluence will not post remotelinks to Jira when inserting a table. This may be for performance reasons (as there may be a large number of issues on any number of pages), but the functionality currently is only if you add a single Jira link, the remotelink will be posted to Jira. When adding a table based on a JQL, the remote linking does not get invoked from Confluence and there is no remote link created in the Jira issues.

Cause

The same behaviour is present on Cloud as well as on-premise instances. There have been suggestions to expand this functionality to tables, but it was decided that would not be pursued at this time:

CONFSERVER-31916 - Adding more than one issue to the JIRA Issues macro on Confluence does not create the reciprocal "mentioned in" issue link on JIRA

CONFCLOUD-31916 - Adding more than one issue to the JIRA Issues macro on Confluence does not create the reciprocal "mentioned in" issue link on JIRA

Solution

As a workaround we suggest running a batch update in Jira on the same JQL resultset as added in Confluence, to add the remotelink of the Confluence page where they are displayed. Additionally, any Jira link created individually form a Confluence page will create the remotelink as expected, for additional troubleshooting info see:

"Mentioned in" Confluence page is not displaying on individual Jira issues

Updated on March 21, 2025

Still need help?

The Atlassian Community is here for you.