Managing Users
| 
PDF |
Viewing Users
To view a list of JIRA users:
- Log in as a user with the 'JIRA Administrators' global permission.
-
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:
-
Select User Browser from the Users,
Groups & Roles section of the administration
menu. This will display the User Browser screen:
-
To restrict the list of users shown in the User Browser, use the Filter
form at the top of the User Browser. Specifying (part of) the user's email and/or group, then
clicking the Filter button, will reduce the list
to only those users who match those criteria.
Adding a User
- Open the User Browser (see 'Viewing Users' above) and click the
Add User link.
- This will display the Create New User form. Enter the Username
(note that a user's Username cannot be changed once the user is created),
Password, Full Name and Email Address; and
(optionally) tick the box to send the user an email containing
their account details. Then click the Create button.
Note
Users can also be created via:
-
Signup — see "
Enabling Public Signup"
-
Email — e.g. you can use the CreateIssueHandler (see "
Services")
to have JIRA create a user based on the sender's email address.
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:
- Locate the user in the User Browser (see 'Viewing Users' above)
and click the Groups link in the Operations column.
- 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.
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 ABC 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 DEF project, May 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 tick (to add
the user to a project role) or un-tick (to remove the user from a project role).
Changing a User's Name or Email Address
- Locate the user in the User Browser (see 'Viewing Users' above)
and click their Edit link in the Operations column.
- This displays a form where you can change the user's Full Name or Email Address.
Click Update to confirm the change.
Changing a User's Password
- 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. Click the Set Password
link.
- This displays the Set Passwordscreen. Enter and confirm the new password;
then 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:
- 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. Click the Edit Properties
link.
-
This displays the Edit User Properties screen, showing any previously-created
properties:
- Enter the new Key and its Value, then click the Add
button.
Deleting a User
Note
Rather than deleting a user, it is recommended to disable their account by removing them from
all groups (see 'Assigning a User to a Group', above). This prevents the user's account from being used. It is still
important to reassign any issues assigned to that user, but there is no need to modify the 'Reporter' as described below.
To delete a user,
- Locate the user in the User Browser (see 'Viewing Users' above)
and click the Delete link in the Operations column.
-
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 bob results in
the following screen, which prevents deletion due to the presence of 10 assigned 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.
- 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.
Note
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.
