Cannot Link to Confluence Space while creating a new project and option is greyed out.
Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.
Summary
While creating a new project, we get an option link to Confluence (along with other external tool). The Conflunece option however is greyed out and if we hover over it, we get error:
"You do not have permission to create or link a space"
Environment
- JIRA Cloud
- Confluence Cloud
Diagnosis
- Validate that user have access Confluence and can successfully access multiple Spaces/Pages
- Successfully able to link Space/page via the "project pages" option in Jira project once the project is created.
Cause
In default project permission scheme, which is linked to new projects, had only "Project Roles" mentioned for few permission which are required to link confluence pages with Jira successfully i.e:
- Browse project
- Create Issue
- Edit Issue
This means untill the project is created and the user who created project is not explicitly added in Project Roles (specified in permission scheme), the user does not have these permissions.
Solution
In the default permission scheme which is getting added to new projects, add a group (example site-admins or any project where the user responsible for project creation is added) for permissions Browse project, Create issue and Edit issue.
Doing so, when the new project is created and a the permission scheme will be associated with it, the user will have all the required permissions and will get option to link confluence pages. This eliminated the need to add this user to permission scheme via project roles later.