On this page:

Project permissions are created within Permission Schemes, which are then assigned to specific projects.

Project permissions can be granted to:

• Individual users
• Groups
• Project roles
• Issue roles such as 'Reporter', 'Project Lead' and 'Current Assignee'
• 'Anyone' (e.g. to allow anonymous access)
• A (multi-)user picker custom field.
• A (multi-)group picker custom field. This can either be an actual group picker custom field, or a (multi-)select-list whose values are group names.

The following table lists the different types of project permissions and the functions they secure. Note that project permissions can also be used in workflow conditions.

Permission Schemes

What is a Permission Scheme?

A permission scheme is a set of user/group/role assignments for the project permissions listed above. Every project has a permission scheme. One permission scheme can be associated with multiple projects.

Why Permission Schemes?

In many organisations, multiple projects have the same needs regarding access rights. (For example, only the specified project team may be authorised to assign and work on issues).

Permission schemes prevent having to set up permissions individually for every project. Once a permission scheme is set up it can be applied to all projects that have the same type of access requirements.

Creating a Permission Scheme

1. Log in as a user with the 'JIRA Administrators' global permission.
2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
3. On the panel on the left, under the title 'Schemes', click the link labelled 'Permission Schemes'.
   
4. This will display the 'Permission Schemes' page. This page lists all of the Permission Schemes that JIRA currently has. Click the 'Add Permission Scheme' link.
   
5. In the 'Add Permission Scheme' form, enter a name for the scheme, and a short description of the scheme. Click the 'Add' button.
   
6. You will return to the 'Permission Schemes' page which now contains the newly added scheme.
   

Adding Users, Groups or Roles to a Permission Scheme

1. On the panel on the left, under the title 'Features', click the link labelled 'Permission Schemes'.
   
2. Click the 'Permissions' link or on the name of the Permission Scheme to show a list of permissions
   
3. Click the 'Add' link in the 'Operations' column.
   
4. This will display the 'Add Permission' page. After selecting one or more permissions to add and who to add the selected permissions to, click the 'Add' button. The users/groups/roles will now be added to the selected permissions. Note that project roles are useful for defining specific team members for each project. Referencing project roles (rather than users or groups) in your permissions can help you minimise the number of permission schemes in your system.
   
5. Repeat the last 2 steps until all required users/groups/roles have been added to the permissions.
6. To delete a user/group/role from a permission click the 'Delete' link in the "Users / Groups / Roles" column.
   

Associating a Permission Scheme with a Project

1. Log in as a user with the 'JIRA Administrators' global permission.
2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
3. A list of projects is displayed
   
4. Select the project you want by clicking on the project name. This will display the project details
5. Click the 'select scheme' link beside the Permission Scheme caption.
   
6. This will bring up a list of Permission Schemes. Select the Permission Scheme that you want to associate with this project.
   
7. Click the 'Associate' button to associate the project with the permission scheme.

Deleting a Permission Scheme

1. Log in as a user with the 'JIRA Administrators' global permission.
2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
3. On the panel on the left, under the title 'Features', click the link labelled 'Permission Schemes'.
   
4. This will display the 'Permission Schemes' page. This page lists all the Permission Schemes that are currently defined in your JIRA system. Click the 'Delete' link for the scheme that you want to delete.
   
5. A confirmation screen will appear. To delete click 'Delete' otherwise click 'Cancel'.
   
6. The scheme will be deleted and all associated projects will be automatically associated with the Default Permission Scheme. (Note that you cannot delete the Default Permission Scheme.)

Copying a Permission Scheme

1. Log in as a user with the 'JIRA Administrators' global permission.
2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
3. On the panel on the left, under the title 'Features', click the link labelled 'Permission Schemes'.
   
4. This will display the 'Permission Schemes' page. This page lists all of the Permission Schemes that JIRA currently has. Click the 'Copy' link for the scheme that you want to copy.
   
5. A new scheme will be created with the same permissions and the same users/groups/roles assigned to them.
   

Additional Resources

• Permission scheme overview tutorial video - Watch this short tutorial video to see how to set up a new permission scheme to control which users can perform which operations on an issue. Please note the JIRA version of the tutorial video before watching.