Integrate Jira Cloud with Confluence Server
This page includes details about integrating Jira Cloud with Confluence Data Center or Server.
In summary
Application links
In-product integration
Using Confluence as knowledge base for Jira Service Management Show
Features available through application links
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.
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:
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
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.
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.