Documentation for JIRA 5.2. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

Viewing users

To view a list of JIRA users:

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose at the top right of the screen. Then choose Users > Users to open the 'User Browser' page.
    (tick) Keyboard shortcut: g + g + start typing users
    Screenshot: The User Browser
  3. To restrict the list of users shown in the User Browser, use the Filter form at the top of the User Browser.
    (info) Specifying (part of) the user's username, full name, email address and/or group membership, then clicking the Filter button, will reduce the list to only those users who match those criteria.
  4. To view details and login information about a user in the list, click their Username or Email Address.
    Screenshot: User Details

On this page:

 

Adding users

Users can be created via any of the following methods:

  • Add the user directly into JIRA — see Adding a User below. You can create one user at a time, using this method.
  • Invite users via email — see Inviting Users below. You can invite multiple users at the same time, using this method.
  • Allow users to sign up — see Enabling Public Signup.
  • Automatically create users when issue/comment creation emails are received from unknown email addresses — You can use a mail handler to allow JIRA to create issues or comments via emails received. The handler can also be configured to create new users based on the sender's email address. See Creating Issues and Comments from Email.
  • Connect to an Internal Directory with LDAP Authentication — see Copying Users on First Login.

(info) Please Note: If you have a user limited license (e.g. starter license) and have reached your user limit, any further users created will not have permission to log in to JIRA

Creating a user

  1. Open the User Browser (see Viewing Users above) and click the Add User button to open the 'Add New User' dialog box.
  2. Enter the Username (note that this value cannot be changed once the user is created), Password, Full Name and Email address.
  3. Optionally, select the Send Notification Email  check box to send the user an email containing:
    • their login name; and
    • a link from which to set their password (this link is valid for 24 hours).
  4. Click the Create button.

Inviting users

You can invite one or more users to JIRA via email. Note, JIRA's SMTP mail server must be configured to send notifications before you can invite users via email.

  1. Open the User Browser (see Viewing Users above) and click the Invite Users button to open the 'Invite Users' dialog box.
  2. Enter the email addresses of the users that you want to invite. Enter each address on a new line or separate addresses using commas.
    Note, you cannot invite users by sending an invitation to a mailing list.
  3. Click the Send button. An invitation to create a user account in JIRA will be sent to each email address.
    • Each invitation can only be used to create a user under the email address that it was sent to, and can only be used once.
    • Each invitation will expire seven days after the day it was sent.
    • Your user license count will not be affected until users accept the invitation and the users are created. 
    • Users that are created via the invitation will be added to the 'jira-users' group.


Assigning a user to a group

When a user is created, they will be added to any groups that are set up to have new users automatically added to them.

To change a user's group membership:

  1. Locate the user in the User Browser (see Viewing Users above) and click the Groups link in the Operations column.
  2. This will display two lists; the one on the left shows all available groups, and the one on the right shows all groups to which the user currently belongs. Use the Join and Leave buttons to add the user to or remove them from your selected group.

(info) Please Note: If you have a user limited license (e.g. starter license) and have reached your user limit, you will not be able to assign any further users to groups with login permissions (i.e. jira-users permission) without first reducing the number of users with login permissions.

Assigning a user to a project role

Assigning a user to a project role enables them to fulfil a particular function in a particular project.

To view a user's project role membership, locate the user in the User Browser (see Viewing Users above) and click the Project Roles link in the Operations column. This will display a table showing all the projects and project roles that exist in JIRA, and the user's current project role membership for each project:


e.g. this screenshot shows that, for the 'First Project' project:

  • Mary is a member of the 'Administrators' project role.
  • Mary is not a member of the 'Developers' project role.
  • Mary is indirectly a member of the 'Users' project role, through being a member of the 'jira-users' group.
    (Also note that, for the 'Third Project' project, Mary is both a direct and an indirect member of the 'Users' project role.)

Click the Edit Project Roles button. The check boxes will then be available for you to select (to add the user to a project role) or clear (to remove the user from a project role).

Changing a user's name or email address

  1. Locate the user in the User Browser (see Viewing Users above) and click their Edit link in the Operations column.
  2. In the resulting form, make the required changes the user's Full Name and/or Email address.
    (warning) Do not clear the Active check box unless you want to deactivate this user.
  3. Click Update to confirm the change.

Changing a user's password

  1. Locate the user in the User Browser (see Viewing Users above) and click their Username. This displays the user's details, below which are several links.
  2. Click the Set Password link. This displays the Set Password screen.
  3. Enter and confirm the new password.
  4. Click the Update button.

Adding a property to a user

A 'Property' is an extra piece of information that you can store regarding a user. A Property consists of a Key of your choice (eg. 'Phone number', 'Location') plus a corresponding Value (eg. '987 654 3210', 'Level Three').

To create a new Property for a user:

  1. Locate the user in the User Browser (see Viewing Users above) and click their Username. This displays the user's details in a box.
  2. Click the Edit Properties link towards the end of the page.
  3. This displays the Edit User Properties screen, showing any previously-created properties:
  4. Enter the new Key and its Value, then click the Add button.

Deactivating a user

JIRA administrators can 'deactivate' a JIRA user, which disables that user's access to JIRA. This avoids the need for a JIRA administrator to delete the user's account from the system.

This feature is useful when a JIRA user leaves an organisation because a deactivated user's history of JIRA activity is preserved on the system. If a user with a deactivated JIRA account rejoins the organisation at some point in the future, their JIRA user account can be re-activated.

To deactivate a user account:

  1. Locate the user in the User Browser (see Viewing Users above) and click their Edit link in the Operations column.
  2. In the resulting form, clear the Active check box.
  3. Click Update to confirm the change.
    (info) To re-enable the user again, repeat the steps above but instead, select the Active check box.

While a JIRA user account has been deactivated, that user:

  • Will no longer be able to log in to JIRA.
  • Cannot be assigned issues or added as a watcher to issues (whenever issues are created or edited). However:
    • A user who was assigned, was watching or had reported any issues in JIRA before their account is deactivated, will still appear as the respective assignee, watcher or reporter of those issues. This situation remains until another user is specified as the assignee or reporter of these issues, or the deactivated user is removed as a watcher from them.
    • A user who voted on any issues in JIRA before their account is deactivated, will continue to appear as a voter on these issues.
  • Will continue to appear on the JIRA user interface with '(Inactive)' displayed after their name, where applicable.
  • Can still be used to filter issues in a JIRA search query.
  • Will not receive any email notifications from JIRA, even if they continue to remain the assignee, reporter, or watchers of issues.
  • Will not count towards your JIRA user license limit. Refer to the JIRA Users global permission explanation on Managing Global Permissions for more information.

(info) Please Note:

  • Users who are project or component leads cannot be deactivated. To deactivate these users, assign other users as the relevant project or component leads first.
  • Any JIRA site's users who are configured in an external Atlassian Crowd user directory and deactivated in Crowd, will be deactivated in JIRA.
  • With the exception of JIRA users configured with 'delegated LDAP authentication', JIRA does not deactivate users who are configured and deactivated/disabled in an external Microsoft Active Directory or LDAP-based user directory.

Deleting a user

(info) Rather than deleting a user, we recommend that you deactivating their account instead (as described above). Deactivating a user's account will prevent that account from being used and prevent anyone from being able to log in to JIRA using that account. However, it will preserve that user's history of activity on JIRA.

(warning) Please Note: Before you delete a user, you should bulk-edit the issues involved and change the reporter to someone else. You will need the Modify Reporter permission to change the reporter for the issues. You will also need to allow editing of closed issues if some of the issues the user created are closed and you do not wish to reopen them.

To delete a user:

  1. Locate the user in the User Browser (see Viewing Users above) and click the Delete link in the Operations column.
  2. The confirmation screen that follows will summarise any involvement of that user in the system by showing current issues assigned to and reported by that user, etc. These connections between the user and other parts of the system may prevent the deletion of that user. For example, attempting to delete a user called test-user results in the following screen, which prevents deletion due to the presence of one assigned and two reported issues:

    As well as reassigning any issues, you may need to bulk-edit the issues created by the user and change the 'Reporter' to someone else. You'll need the 'Modify Reporter' permission to do this.
  3. If there are no issues assigned to, or reported by the user, the confirmation screen will display a Delete button; click this to proceed with the deletion.

(info) Please Note:

  1. Please note that the filters and dashboards of a user will be deleted when the user is deleted, regardless of whether the filters or dashboards are shared with other users.
  2. Any numbers of issues which have been reported by or assigned to the user you are attempting to delete, are respectively hyperlinked to a list of the individual issues (in the Issue Navigator).

Notes

  • If you are using External User Management, you will not be able to create, edit or delete users from within JIRA; but you can still assign users to project roles, and create/edit/delete user properties.
  • If you have JIRA connected to either a delegated LDAP directory or an LDAP directory set to 'Read Only' (see Connecting to an LDAP Directory for details), you will not be able to change a user password from within JIRA.
  • Multiple user directories:You may define multiple user directories in JIRA, so that JIRA looks in more than one place for its users and groups. For example, you may use the default JIRA internal directory and also connect to an LDAP directory server. In such cases, you can define the directory order to determine where JIRA looks first when processing users and groups. Here is a summary of how the directory order affects the processing:
    • The order of the directories is the order in which they will be searched for users and groups.
    • Changes to users and groups will be made only in the first directory where the application has permission to make changes.

    See Managing Multiple Directories.

 

 

11 Comments

  1. Hello, May I ask a question?

    If I created a new user, and I did not set password, I left Password blank.

    So what's the password of the new user?

    I failed to log on with password blank 

  2. Hello Teng, please contact JIRA Support so that they can help you resolve this issue. You can click the Get Support link at the bottom of this page for further assistance.

  3. Anonymous

    Regarding disabling a user vice deleting a user. What happens with the license in each case? I assume that deleting a user frees up a seat in your license. What about disabling a user? Is the seat held in their case or is it freed up for use by another user if one is created?

    Thank you!

  4. Anonymous

    Anon, as it says above:

    "While a JIRA user account has been deactivated, that user:
     

    • Will not count towards your JIRA user license limit. Refer to the JIRA Users global permission explanation on Managing Global Permissions for more information.
  5. Anonymous

    Thank you Anon. I completely missed that while I was reading through this section.

     

  6. How do I get a count of my current Active users? I can only seem to find a count of ALL users, which includes those that have been deactivated. Thanks!

  7. Still looking for an answer to my question of Apr 15, 2013.  We have a limited-users license. I know that once a user has been deactivated, they should not count against my license. How do I find out how many active users I have, so I know how close I am to my license maximum?  Neither my "All Users" count nor my "qit-usr" group membership count goes down when I deactivate a user.  Is there another way to get this information?  Do I need to query the back-end database directly? Thanks!

    1. Hello, the best place to go for questions and answers is https://support.atlassian.com/. Someone there should be able to help out with your query. Thanks.

    2. Anonymous

      If you have administrator rights, you can go to Administration - System - License and that should show you the current license count (I'm using a 5.2.x system)

  8. Thank you Anonymous. We're using 5.2.x as well and I cannot see that information under Administration > System > License. We're currently using an Evaluation license, so perhaps that's why. I DID discover that when I attempt to ADD a new user, my current user count is displayed. So that is one way to do it, albeit a roundabout way.