Connection failed error during link between Jira Cloud and Confluence Cloud

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

You are unable to link an existing Confluence Cloud space or create a new space from Jira Cloud project pages

Diagnosis

  • Project pages > Connect to Confluence fails with "Connection failed" error

  • Project settings > Toolchain > Add documentation space > Confluence does not show any spaces

  • If Confluence is already added in the toolchain, "Add documentation space" is greyed out

Cause

This issue is caused due to insufficient user permissions on the Jira project or in Confluence. 

Solution

Fix permissions in Jira Cloud

For more info on Jira permissions, please refer to our documentation.

In order to link a Jira project to a Confluence space, you need to be able to browse projects in Jira.

If you're a Jira admin, you can check this by navigating to your Jira project and selecting Settings > Permissions.

Fix permissions in Confluence Cloud

For more info on Confluence permissions, please refer to our documentation.

To create a new space, you need the global Confluence administrator and Create space permissions. To manage these permissions, go to your Confluence global permissions.

Make sure you or the Confluence group you belong to has the View permission for that space. If you're a Confluence admin, you can check this by navigating to your Confluence space and selecting Space settings > Permissions.

Updated on June 17, 2025

Still need help?

The Atlassian Community is here for you.