Cannot link existing Confluence space to a Jira Software project

Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Upon trying to link a Confluence space to a JIRA Software project, different symptoms will be displayed, avoiding the space to be selected.

Environment

  • Confluence Cloud

  • JIRA Software Cloud

Diagnosis

Scenario #1:

  1. Access your Jira Software project.

  2. Click Project Settings from the sidebar.

  3. Click Features.

  4. Scroll the page until you find More Items > Try to add Pages.

  5. The toggle to enable pages will be greyed out.

Scenario #2:

  1. Create a new project (Jira Software: company-managed)

  2. Type a Name, choose a key, and select the checkbox for "Connect repositories, documents, and more" > click Next

  3. Confluence Cloud is not showing as an option for Create Space.

Cause

The user is missing permission(s).

Solution

On Jira (more info on permissions here):

  • In order for you to link a Jira project to a Confluence space, you need to be able toBrowse Projectsin the Jira project. If you're a Jira admin, you can check this by navigating to your Jira project and selecting Settings > Permissions.

On Confluence (more info on permissions here):

  • 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 February 25, 2025

Still need help?

The Atlassian Community is here for you.