Customizing Jira Service Desk permissions

Still need help?

The Atlassian Community is here for you.

Ask the community

If you want to customize the permission scheme for your service desk, make sure that you grant permissions to users by granting them:

  • to the Administrators role for administrators
  • to the Service Desk Team role for agents
  • to the Service Desk Customer - Portal Access security type for customers. 

If you grant permissions to groups or individual users instead of the roles and security type, some functionality in your service desk might be disabled.

Mandatory permissions by project roles

If you choose to use custom permission schemes, the permissions in the following table are mandatory for the project roles in the typical service desk context. If you configure the permissions for the roles differently than shown in the table and run into problems, you can find the explanation of the problems and how you can fix them on Resolving Jira Service Desk permission errors.

Project role
Mandatory permissions
Administrators

This project role must have the Administer Projects project permission in order to set up and administer a service desk. This permission allows users to manage service desk functionality like creating new request types, setting up new queues, creating SLAs, and generating reports.

This project role also must have all the permissions granted to the other users of the service desk in order to see all the functionality they'll be using.

Service Desk Team
  • Create Issues (This permission gives users the ability to create issues in a Customer Portal.)
  • Browse Projects (This permission gives users read-only access to the ReportsPeople, and SLA tabs in a service desk project, as well as access to the project's Customer Portal. Users can also see the Queues tab and work on issues from within the queues.)
  • Edit Issues
  • Schedule Issues
  • Add Comments
  • Create Attachments
Service Desk Customers

The permissions for customers must be granted to the Service Desk Customer - Portal Access security type, not the Service Desk Customers role. The Portal Access security type lets customers access the customer portal, but not Jira. The security type reads the role to determine who are customers.

Mandatory permissions:

  • Create Issues (Customers can create requests and view requests they have submitted via the customer portal)
  • Browse Projects (Customers can access the project in the customer portal)
  • Add Comments (Customers can comment on their requests.)

Recommended permissions:

  • Create Attachments (Customers can add attachments to their requests)
  • Assign Issue (This permission is mandatory for the Assignee field to work. The Assignee field is an optional hidden field and it automatically channels issues to certain team members.)

Note: Jira will display a warning when you remove any of the permissions from the default scheme. In most cases, it will be a non-critical error (yellow), which doesn't affect how Service Desk works. If you removed the permissions on purpose, you can safely dismiss this warning, and it won't be shown again. You can read more about it in Resolving Service Desk permissions.

In addition, if the service desk project uses an issue security scheme, make sure that it is configured so that service desk users can view issues. Otherwise, customers might be able to create issues but not view them after they've been created. See Configuring issue-level security.

Last modified on Jan 13, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.