Add or modify a connection to Jira
Add a connection to Jira so that you can embed issue data from that Jira site into Confluence. You can make connections to multiple Jira sites to bring together information from across your organisation.
Connections can be added in Confluence Settings for all spaces, or in Space Settings for an individual space. Note that space connections can be disabled if required.
Connection to Jira added in… | Available to use in… |
|---|---|
Confluence Settings | All spaces |
Space Settings | Only that space |
Add a new connection to Jira
This can be done for all spaces or for an individual space.
Add a new connection for all spaces
Navigate to Confluence Settings in the top navigation bar and then select Display Issue Data from the left navigation under the Apps sub-heading. To locate this, you may need to scroll the left navigation and expand the Apps sub-heading.
Select Add connection from the table (if this is the first connection) or under the table (if there are existing connections). If there are already five connections, you will need to delete an existing connection before adding a new one.
Fill in the connection details and press Save.
Add a new connection for an individual space
Navigate to your chosen space. The Spaces menu in the top navigation is usually the quickest way to do this. From within the space select Space Settings in the left hand navigation, then Display Issue Data under the Integrations sub-heading (you may need to scroll to locate this).
You can also search for Display Issue Data in the Jump to setting… field at the top of Space Settings.
Under This space only select Add connection from the table (if this is the first connection) or under the table (if there are existing connections). Note this option may not be available if space connections are disabled. If there are already five space connections, you will need to delete an existing connection before adding a new one.
Fill in the connection details and press Save.
Edit an existing connection to Jira
If the connection is available in all spaces, edit this in Confluence Settings. If it’s only available within a specific space, edit it in Space Settings for that space.
Edit a connection available in all spaces
Edit a connection available in all spaces from the Display Issue Data page in Confluence Settings.
From the connections table, select Edit next to the connection you want to modify.
Adjust connection details using the form and press Save.
Edit a connection available in only one space
Edit a connection available in only one space from the Display Issue Data page under Space Settings for the space in question.
From the connections table, select Edit next to the connection you want to modify.
Adjust connection details using the form and press Save.
Delete a connection to Jira
If the connection is available in all spaces, delete this in Confluence Settings. If it’s only available within a specific space, delete it in Space Settings for that space.
Delete a connection available in all spaces
Delete a connection available in all spaces from the Display Issue Data page in Confluence Settings.
From the connections table, select Edit next to the connection you want to delete.
Select Delete in the bottom right of the form.
Delete a connection available in only one space
Delete a connection available in only one space from the Display Issue Data page under Space Settings for the space in question.
From the connections table, select Edit next to the connection you want to delete.
Select Delete in the bottom right of the form.