Jira Service Management: Managing customers in Jira Service Management
On this page
Jira Service Management customers are users who create requests for the service team to work on. They do not have access to the service project interface in Jira used by agents. Customers do not consume Jira Service Management licenses or Jira user licenses. In other words, customers are completely free and unlimited.
- Create requests and track their own requests
- Add comments to their own requests
- Add comments to requests on which they have been made a participant
- Add comments on requests that are shared with an organization they are a member of
Every customer must have an account to create requests. They need to log in to use the Customer Portal. When customers contact your service project with the email channel for the first time, new user accounts will automatically be created for them if public signup is enabled. If your service project is configured to allow public signup, a customer can cc: recipients in their original email and those recipients will be created as customer accounts as well.
If the service project does not allow public signup, emails sent by unregistered email addresses are not processed.
All purchases of Jira Service Management made on and after 10 September 2014 are on the version 2 license, i.e. the new agent-based pricing model. For instructions on user management for version 1 license, see Setting up users with the version 1.x pricing.
Managing customers and their requests
You can find customers and the requests they created in your service project by using the Customers section on the project sidebar. We refer to this section as the customer list. You can search for customers that do not appear on the list.
To look at requests created by a customer, use the Open requests and Closed requests columns on the list.
There are a number of ways to add customers to your service project.
Allowing customers to sign up for user accounts
Public signup allows your customers to create accounts themselves. As new customers sign up, they will be added to your service project's customer list.
To enable public signup, see Configuring public signup.
Adding customers to your service project manually
To add customers manually:
- In your service project, click Customers on the project sidebar.
- Click the Add customers button, and enter the email addresses of the customers. You may enter multiple email addresses here, or copy/paste multiple email addresses.
Note: Mailing lists do not work.
Invited customers will then receive an email invitation that links them to your Customer Portal. They can log in to your portal if their email already exists in the system, or they will need to fill in details for their account and set the password after landing on the portal.
Customers are added as members automatically after you invite them to your service project.
Adding customers to your service project by groups with the project role
You can also add customers by adding them to the Service Project Customers project role.
- Open the service project in the administration console, go to Administration > Projects.
- Choose your service project.
- Open the Users and Roles section from the sidebar.
- Click the Add users to a role link. You can enter individual users or groups.
- Select Service Project Customers from the drop-down menu below the users/groups you're adding.
- Click Add
The users in the groups you added will then have customer access to your service project.
Notes on using Atlassian Crowd to manage customers
If you want to set up default groups for customers, use caution and do not use any groups that have application permissions associated with them. This could unintentionally cause your customers to be considered paid users. If you want Jira users, Jira Service Management customers, or both to be added to default groups, you need to use separate directories in Crowd for each type of user. Make sure that the default groups for Jira Service Management customers do not have the Jira User global permission.
If you use Atlassian Crowd and its single sign-on (SSO) capabilities to manage users:
- In order for public signup to work, in Jira, set the Crowd permission to be Read/Write. To do this, go to User management > User directories.
- When configuring who can authenticate to Jira via Crowd, if you have customers that do not belong to groups, make sure you select the setting that allows all users in the directory to authenticate. See Mapping a Directory to an Application.