Exploring Jira and Confluence Integration for Better Collaboration - Valiantys - Atlassian Platinum Partner

Exploring Jira and Confluence Integration for Better Collaboration

Many of you use Jira and Confluence. But are you fully exploiting the potential of integrating these two tools? This article focuses on native features that allow you to link Jira and Confluence, increasing the power of your collaborative platform.

1. Listing your Jira requests in Confluence

It is possible to view Jira requests from Confluence using the Jira Issues macro. This is one way to integrate your Jira and Confluence instances. To accomplish this task:

  1. Open the Confluence page in editing mode;
  2. Position the cursor where you wish to insert your Jira query table. You can move this item later if you wish;
  3. Select the Jira Issues macro from the macro browser;
  4. Enter the search criteria in JQL format and confirm.


List Jira requests in Confluence

2. Creating your Jira requests from within Confluence

Another feature of the Jira Issues macro is the ability to create Jira or Jira Service Desk requests from within Confluence. There are two ways to do it. Here’s the first:

Option 1— The Fastest Method

  1. Go to any Confluence page you like;
  2. Select the text you want to use to create your request in Jira;
  3. Fill in the fields as shown below.

The results will immediately be visible in Jira. Note that the link to return to Confluence is automatically created in the Jira request.


Create requests from Confluence - fast method


Option 2—Via Jira Filter/Request

In this case, you’ll want to switch to editing mode on your Confluence page, then follow the guide—it’s very easy.

  1. enter edit mode
  2. click on the Jira Issue macro and click edit
  3. Click Create New Issue


Create requests from Confluence - method 2


The result is the same as for Option 1: the link to the Jira ticket will appear on your Confluence page as soon as you have confirmed everything.


3. Viewing Jira dashboards in Confluence

It’s also possible to integrate your Jira dashboard gadgets into Confluence. To do so, you must first register them as described here and shown below:

View dashboards in Confluence


The gadget is now available in Confluence and accessible in the macro browser, as you can see here.

4. Viewing Confluence pages in a Jira dashboard

Similarly, it is possible to display Confluence pages as gadgets in a Jira dashboard.

  1. Export the gadget from Confluence;
  2. Save the gadget in Jira to make it available:


View Confluence pages in Jira


3. In Jira, select the gadget to add your Confluence page to the Jira dashboard as follows:


Select gadget


5. Linking Jira requests to Confluence pages

The most knowledgeable of you certainly know that it is possible to link a Jira application to a Confluence page.
Doing so takes only 3 steps:

  1. Click the “Link” button, from the “More” menu of the Jira application display screen;
  2. Select the “Confluence Page” tab, as shown in the illustration below;
  3. Find the Confluence page you want, and confirm.


Link requests


6. Powering a knowledge base with Jira Service Desk

Confluence user guide articles and technical documentation pages can be turned into knowledge base articles, which can then be linked to Jira Service Desk to give users valuable infomation that could potentially solves their issues. It acts as a self-serve online library of information about a product, service, department, or topics.

Click here to read more on the different steps needed to create a knowledge base with JSD and Confluence.

7. Creating a table of Jira requests in a Confluence page

Get the JQL of the Jira requests you want to insert on the page, and then insert a Jira Issue Filter. Paste the JQL and select the columns you want to be displayed on the table. Then click insert and save the page. A list of the Jira issues relating to your JQL will appear.


Create table of Jira requests in Confluence


8. Creating Jira reports on a Confluence page

To create Jira report pages that can be used for presentations or to visualize the progress of your work, simply add a Jira report by following the steps shown below.


Create Jira reports on Confluence


The features mentioned in this article are available natively and do not require any particular development work or app. However, they require pre-configuration. Don’t hesitate to contact us or register for our Jira and Confluence training sessions if you need guidance.

Cutted Triangle

Subscribe to the Valiantys Newsletter

Registered request ! Subscribing... This is not an email An error occured

In accordance with our privacy policy, we are committed to respecting your personal data.

Contact us

Our Atlassian certified consultants will be happy to answer you.

Join us

We're building the next dream team - Are you in?

Follow us

We use cookies for the operation of our website. This is to improve its use, to personalize your experience, and to compile visitor statistics. By continuing to use this site, you consent to this policy. You can manage the settings and choose whether or not to accept certain cookies whilst browsing. For more information, see our privacy policy. Our privacy policy

Privacy settings

In order to facilitate your navigation and to provide you with the best possible service, we use cookies to improve the site to the needs of our visitors, particularly according to the number of visitors. For more information, please read our privacy policy. Our privacy policy


Google reCAPTCHA is a system designed to distinguish humans from computers, so that bots are unable to maliciously fill out forms on behalf of a human being.


Used to send data to Google Analytics about the visitor's device and behavior. Tracks the visitor across devices and marketing channels. Used by the social sharing platform AddThis to store the user's usage history of the AddThis sharing widget. Registers a unique ID that is used to generate statistical data on how the visitor uses the website.


Targeting Cookies: Targeting cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant advertising on other sites. They are based on uniquely identifying your browser and internet device. You can turn off the use of cookies for targeted advertising here. When the button is green, targeted cookies are on. When the button is red, targeting cookies have been turned off.

Social Media Cookies: These cookies are set by a range of social media services that we have added to the site to enable you to share our content with your friends and networks. They are capable of tracking your browser across other sites and building up a profile of your interests. This may impact the content and messages you see on other websites you visit. If you do not allow these cookies you may not be able to use or see these sharing tools.