1. Missing Jira emails

You may notice that your user emails are not being returned for your Jira integration. This is because the profile visibility settings in Jira hide email information from a user's profile by default. You can learn how to update those settings to make the user emails visible here!

2. Missing access to projects in Jira

If you're unable to view Jira projects in Merge's Collections model, listed below are a few places to check that the end user has configured the correct permissions within their Jira application.

Confirm user access to the Jira app

1. Go to Jira Admin → Directory → Users.

2. Select the user used to connect this account.

3. Under Roles, confirm that your user has at least User role access to the Jira app.

   

4. If your organization provisions access at a Group level, navigate to Jira Admin → Directory → Groups.

5. Under Roles, confirm that the group your user is associated with has at least User role access to the Jira app.

   

Confirm access to view company-managed projects

1. Navigate to Project Settings.

   1. Settings → Projects → More actions → . . . → Project settings

      
      

2. Navigate to Project settings → People

   1. The roles you can choose from defined in System settings (see note here).

   

3. Confirm that your user has access to view this project.

   1. To add yourself as a user, click Add people.

   

Define permissions for Project Roles

1. Within Project Settings, navigate to the Permissions tab.

   1. This page notes what Permission Scheme is applied to the Project as well as what issue-level security is defined elsewhere.

   

2. Confirm that that the Browse Projects permissions is enabled for the
   Users / Groups / Project Roles that is associated with the user used to connect this Jira account.

   1. Confirm that any other additional permissions are enabled for your use case:

      1. Administration

      2. Project

      3. Issue

      4. Voters & Watchers

      5. Comments

      6. Attachments

      7. Time Tracking

3. If you need to edit these permissions, navigate to Actions → Edit permissions.

   

4. You will be redirected to the Work items page, where you can update the permissions by either clicking Update for each permission or click Grant permissions.

   
   

Confirm access to view team-managed projects

1. From Project Settings, navigate to Access.

   

2. To modify the project access, click Change project access.

   
   

3. Add users or groups to project access: click Add people.

   

4. Search for the user or group and define their role.

   

5. To view existing project roles or to create a new role, click Manage roles.

   

6. To create a new project role, duplicate one of the existing project roles. Then define the new role and its permissions, including permissions to CRUD project issues.

   

7. Once the permissions are assigned, click Create role.