Integrate Jira Cloud with Confluence Server

Still need help?

The Atlassian Community is here for you.

Ask the community

This page includes details about integrating Jira Cloud with Confluence Data Center or Server.

In summary

(tick) Displaying issues on pages (single issues, list of issues based on filter, issue count) Show

(tick) Linking issues to pages Show

(tick) Using ‘Jira links’ to view linked issues Show

(tick) Creating issues from Confluence Show

(tick) Displaying issue and project information using charts Show

(tick) Linking and creating pages from sprints and epics Show

(warning) Using Jira gadgets in Confluence Show

(warning) Using Confluence gadgets in Jira Show

(error) OAuth with impersonation Show

In-product integration

(tick) Using Confluence as knowledge base for Jira Service Management Show



The following features are available when you link your products with application links. Unless clearly stated, they are available for all Jira applications: Jira Core, Jira Software, Jira Service Management.

Displaying issues on a page

You can add issues to a page by using the Jira issue macro or pasting the URLs. You can display a single issue, filter with multiple issues, or the total count of issues included in a filter.

Filter with multiple issues added to a page: 

Single issue pasted onto a page:

Linking issues to a page

You can open an issue in Jira, and select Link Confluence page, where you can paste your page’s URL or search for a page.

(info) Search will only work if the application link for your Confluence Server is set as primary. This might not be the case if you also have Confluence Cloud in your site. In such a case, you can try manually setting the link as primary – it will work, but it might take a while to apply this change.

Once you link the page, it will appear in your issue.

Using ‘Jira links’ to view linked issues

All issues linked to a page will also appear in the “Jira links” button in Confluence, so you can quickly open them in Jira.

Creating Jira issues from Confluence

You can create Jira issues in two ways:

  • Highlight some text on a page, and click the Jira logo.

  • Use the Jira issue macro. After adding the macro to a page, you can switch to the Create new issue tab.

In both of these options, the issue will be created in Jira, linked to your page, and also pasted onto your page.

Displaying issue and project information using charts

You can use the Jira charts macro to display three charts with information about your projects and issues:

  • Pie chart (report on different issue fields)

  • Created vs. Resolved chart

  • Two dimensional chart (show different issue statistics in a matrix)

Pie chart

Created vs. resolved

Two dimensional

Linking sprints and epics to pages

Available for Jira Software, company-managed projects only

You can create pages from sprints (and link them automatically), or link sprints to existing Confluence pages:

(warning) There’s a glitch where the counter next to Linked pages always shows 0.

You can also created pages from epics (and link them automatically), and link epics to existing Confluence pages:

Using Jira gadgets in Confluence

You can use most Jira gadgets in Confluence after you register them (activity stream, issue statistics, filter results, etc.). Here are some examples:

Issues in progress

Issue statistics


Heat map

(warning) Gadgets related to sprints (Sprint Burndown, Days remaining in sprint, etc.) will not work. The macro to add them is there, but you can’t preview or save them.

Using Confluence gadgets in Jira

You can add the Activity Stream gadget with updates from Confluence to your Jira dashboard. You don’t have to register this gadget.

(warning) You can’t use other Confluence gadgets (Confluence page, Confluence quicknav) because Jira Cloud doesn’t have an option to register external gadgets.

Features available through in-product integrations

Using Confluence as a knowledge base for Jira Service Management

Just like in server, Jira Service Management Cloud supports adding Confluence Server as the knowledge base for your customers. The steps to configure it are similar – you'd first create an application link and then link Confluence spaces to specific projects in Project settings > Knowledge base.

At this time, Cloud doesn't include a detailed documentation on how to do this, but you could use the one for Server. For more info, see Set up a knowledge base with Confluence Server.

Unsupported features

The following features, which you might know from server, aren’t available in cloud:

OAuth with impersonation

OAuth with impersonation is one of the authentication types in application links. It has been deprecated in Atlassian cloud products and can’t be used. You can only use OAuth without impersonation.

Integrate these products

To create the application link, see Create application links.

Last modified on Sep 8, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.