Jira Confluence Integration: The Complete 2023 Guide

adminUncategorized

Jira Confluence integration

In this article, you will learn everything there is to know about setting up an effective Jira Confluence integration.

At first, Jira and Confluence might seem like very different products to you.

On the one hand, you have Jira: a flexible and powerful issue tracker. Confluence on the other hand is an equally valuable content management system.

At this point, lots of businesses wouldn’t even be able to imagine how they would run properly without these tools.

But did you know Jira and Confluence can integrate seamlessly together? Well, they can. And when combined, they make for an incredibly powerful stack.

This guide will explain to you why integrating Confluence with Jira is a power combo. We’ll also discuss in detail how to set up the integration, and you’ll discover exactly what benefits this integration can deliver for you.

Content overview:

Why set up a Jira Confluence integration?

So why would you integrate Jira and Confluence? Well, let’s have a look at the numbers:

  • For one, stats show that if you’re a Jira Software user there is more than a 50% chance you’ll also use Confluence at some point in your career.  That means there are huge efficiency gains to be made by connecting the two.
  • Talking about efficiency gains, according to Atlassian, 76% of Jira Software users said they shipped projects faster after integrating with Confluence.
  • And 66% said doing so improved communication between development teams and non-technical stakeholders.

Meanwhile, the number one cited benefit that it provided was creating a single source of truth for software documentation.

Jira is one of the most powerful task-tracking and Project Management tools out there and it enables deep-level customization. So you can build Jira workflows that are just right for your team.

Jira integration with Confluence

Confluence, meanwhile, allows wider teams to collaborate around documents, plans, and reports. This means you can use Confluence to store technical documentation, as a knowledge base, or to act as a company intranet.

Integrate Confluence with Jira

A Jira Confluence integration can be particularly valuable when it connects the work of these technical teams, using Jira, with the wider business on Confluence.

Effectively, you’ll connect ideas and planning in Confluence directly with tasks and workflows in Jira.  This will save you quite some time and make operations far more efficient.

A specific example could include creating Jira issues and generating charts or reports on Jira activity straight away in Confluence. This will provide your team with an overview of the flow of your tasks and projects. But that is just one example. We will cover more use cases further down this article, so keep reading.

How to integrate Jira with Confluence?

To get started, you will have to install Jira and Confluence as two separate pieces of software. And then you can connect them via an application link.

Note: You’ll need to have admin privileges on both Jira and Confluence to create this two-way link.

Setting up the Confluence Jira integration through the application link

This is how to achieve a Jira Confluence integration using the application link:

  1. First, open your Confluence instance
  2. Go to the settings icon in Confluence
  3. Select General Configuration under Confluence Administration

Confluence all updates

4. Select Application Links in the panel on the left. You’ll then be directed to the Application Links configuration page.

confluence configuration page

5. Enter the URL for the application that you want to connect to Confluence (ie your Jira instance).

6. Click “Create new link”.

Confluence application links

7. Tick “The servers have the same set of users…” and “I am an administrator on both instances”

8. And finally use the wizard to finish configuring the link. If you’d like to learn more about the Setup Wizard, have a look at this Atlassian documentation page.

Connect to JIRA

With that done, your Jira Confluence integration is good to go.

Using the integration for a Jira user directory

Did you know you can delegate user management of Confluence to Jira?

This means you’ll be able to centralize management across both platforms. That will save you time and logistical headaches since you don’t have to manage two sets of users across both Jira and Confluence.

The setup for this is pretty straightforward, using the wizard we just discussed.

The image below illustrates how it works in the wizard. You simply add Jira user groups as Confluence users, so you only have to maintain one user group.

Advances Options

This Setup Wizard allows you to limit cross-platform access to specific Jira user groups. You can do this via the “User Groups” field.

That might be useful for you if cross-platform use would only be relevant for some teams or team members within your organization, or if you’d just want to tighten up security.

How to display Jira issues in Confluence

Want to display a Jira issue on a Confluence page? You can use the Jira issue macro for that.

This functionality will allow you to display:

  1. a single issue
  2. or a list of issues
  3. or to call up a number of issues specified by a query.

And you can do this just by pasting a URL onto the page, for example:

  • <yourjirasite.com>/browse/CONF-1234 – will show a single issue
  • <yourjirasite.com>/issues/?filter=56789 – will show a list of issues, set to the relevant filter
  • <yourjirasite.com>/issues/?jql=project%20%3D%20CONF – will show a list of issues that match the relevant Jira search query

You can also just drop the Jira issues macro onto the page.

To do this, choose “Insert more content” (or “+”) in the editor and then “Jira Issue/Filter”.

Jira issue/filter

You can then navigate to find a specific issue. With the macro in place, you have complete control over how the issue is displayed and how much information is shown.

Jira Macro in Confluence

But this does not only affect your Confluence page. When you add the macro, this Confluence page automatically gets mentioned on the relevant Jira issue.

Have a look:
Confluence page mention on the relevant Jira issue

You can also view Confluence pages from Jira using the Confluence Page Gadget.

How to create Jira issues from within Confluence

Integrating Jira and Confluence also allows you to create Jira issues straight from the comfort of a Confluence page.

To create a Jira issue while on a Confluence page:

  1. Highlight some text on the page and select the “Create Jira issue” icon
  2. Define the project, issue type, and description for the issue and press “Create”

Jira issues from within Confluence

You can also create multiple Jira issues at once by highlighting a table in Confluence, saving you even more time.

To create a Jira issue from the Confluence editor:

  1. Select “Insert” (or “+”) then “Jira Issue” then “Create new issue”
  2. Define the project, issue type, summary, and description for the issue; and press “Create”
  3. Click “Insert”

Jira issue from the Confluence editor

Using the search tab in the Jira Issues menu you can call up a list of issues. This will allow you to check on their status from within Confluence.

status from within Confluence

How to create charts and reports on Jira activity in Confluence

Integrating Jira and Confluence also enables you to pull up charts and reports in Confluence on your Jira issue activity. This is perfect for communicating what the team is working on for the wider organization.

You can achieve this by using the Jira Report Blueprint to create a Change Log or Status report.

Here is how to create a Change Log (listing Jira issues):

  1. Select “Create” and then “Jira Reports”
  2. Choose a Report Type and your Jira server
  3. Select a Project and Fix Version, and then click “Create”
  4. If you want a dynamic (rather than fixed) report, after selecting Report Type, click “Advanced” and then enter a JQL query or the URL of a Jira search; and then click “Create”

create a Change Log (listing Jira issues)

The Blueprint also allows you to create a Status Report, displaying the progress of a Jira project with pie charts defining status, priority, component, and issue type.

To create a status report:

  1. Select “Create” and then “Jira Reports”
  2. Choose “Status Report” and your Jira server
  3. Select a Project and Fix Version (or enter a Jira URL or JQL query), and then click “Create”

create a status report in confluence

You can also use the Jira Chart Macro to create charts.

To do so:

1. While in the Confluence editor, click “Insert” then “Jira Chart”

use the Jira Chart Macro to create charts in confluence

2. Select the type of report you want (see below) and your Jira server

3. Search for issues; you can enter the query using JQL or by simply pasting in a Jira URL directly

4. Click “Display Options” to customize the appearance of your chart

5. And click “Insert”

Insert Jira Chart in Confluence

Options for charts include:

  • Pie charts – segmenting the chart by any of the following: Status; Fix version; Assignee name; Priority; Component; Issue type
  • Created vs Resolved charts – illustrating the number of issues created against the number of issues resolved
  • Two Dimensional charts – displaying statistics in a grid, selecting from Status; Fix version; Assignee name; Priority; Component; Issue type

Two Dimensional charts in Confluence

How to display Jira dashboards in Confluence

You can also display Jira dashboard gadgets in Confluence and can call them up from the Confluence macro browser.

 

Connect Jira and Confluence

To do this, you’ll need to register external gadgets within Confluence.

The easiest approach to achieve this is to subscribe to all of the other application’s gadgets. This allows you to install all the gadgets from a Jira or second Confluence instance.

To make it happen:

  1. Go to “Settings” in Confluence then “General Configuration” then “External Gadgets”
  2. Select the “Gadget Feeds” tab
  3. Enter the base URL for the application that you want to connect to. This might look like http://example.com/jira or http://example.com/confluence.
  4. Then click “Add” and Confluence will turn the URL into a gadget feed

How to display Confluence pages in Jira dashboards

You can also display Confluence pages in your Jira dashboards.

 

Connect Confluence Gadgets with Jira

With Jira-Confluence Application Links in place, you can select the Confluence Page Gadget from Jira’s gadget directory.

When placing the gadget you’ll be able to customize how it will appear.

How to quickly switch between Jira and Confluence

Of course, sometimes you will want to move between the two platforms. It can be a serious pain when you have to do this manually, but your integration makes that easier as well.

If your Jira Confluence integration is via the application link, you will see a “Jira Links” button at the top of the page in Confluence. This allows you to quickly and easily toggle between the two platforms.

switch between Jira and Confluence

It also shows the number of Jira issues that have been associated with the relevant Confluence page. And, via a dropdown, this will provide you with details of all the issues, sprints, and epics that you have permission to view.

Apps to connect Jira and Confluence

Apps can greatly extend the functionality of your Jira and Confluence platforms. Here are a couple of examples that are specifically geared to assisting Jira-Confluence integration.

jira issue report

  • Issue Macro from Jira to Confluence allows you to control precisely how Jira issues will appear in Confluence. If you have multiple connected Jira instances, you can select which one to pull from and filter by ID, and issue ID using Jira Query Language (JQL). You can also view linked issues and sub-issues, just like you can in Jira.

issue macro from Jira to confluence

  • Advanced Jira Issue Insert Macro provides options for inserting Jira issues into Confluence pages as well as enhancing traceability for issues. The app also assists with creating rich specifications, design, and planning pages in Confluence

calendars for Confluence

  • Team Calendars for Confluence can help to enhance your ability to track activity in Jira. The app enables you to create Timeline Calendars, to help you plan ahead; to follow versions, issues, and agile sprints; and to pull up issues over specified date ranges.

Conclusion

In this guide, we’ve explored:

  • Why integrate Jira with Confluence
  • How to set up Confluence and Jira
  • How to use Jira as a user directory, to centralize management
  • How to display Jira issues in Confluence, providing visibility across platforms
  • How to create Jira issues from Confluence, pairing projects and tasks
  • How to create charts and reports on Jira activity in Confluence, offering overview and oversight
  • How to quickly switch between Jira and Confluence, so you can move quickly when you have to
  • Some apps can help connect Jira and Confluence, making the integration even more valuable

Connecting Jira and Confluence can provide huge benefits in joining up your organization and ensuring that information is shared as well as simply making it accessible.

By improving cross-departmental collaboration, your organization should be able to work better, faster, and with a clearer picture of what lies ahead.

This kind of integration also forms a key part of the project management approach we implement at iDalko.

Recommended Reads: