User Import
User Import is a feature that allows you to add many team members to Jira. To use User Import, you must create a user list file by saving the Email address to a CSV or XLSX format.
Download the user list template
Go to Apps > Bulk User Import in the navigation bar.
Select User Import in the left sidebar.
User Import screen appears, Click Download in the User Import template.
Open the downloaded users_template.xlsx file.
On This Page
Create user list
Open the downloaded User Import XLSX template.
User Import XLSX template consists of Email and Group fields.
Email: Input the user's Email address. Email is a required field and must be entered.
Group: Group name is not mandatory. Optionally, type the name of a group to add users other than the default group. Groups can be multiple, separated by semi-colon(;). If you empty the Group field, users are added to the default group only.
By default, all registered users are added to the default group.
Group names are case-insensitive per Atlassian policy.
Bulk User Import does not validate the Email addresses in the CSV/XLSX file.
On This Page
Import user list
Go to Apps > Bulk User Import in the navigation bar.
Select User Import in the left sidebar.
User Import screen appears, Click Select a file in the Import user list.
<Open> screen appears, select the CSV or XLSX file to which you added the list of users.
Click Next on the User Import screen.
On the Field Name Mapping screen, map the User field name to the CSV/XLSX file Header name.
Email ID: Select CSV/XLSX file header name. Select Email.
Group(s): Select CSV/XLSX file header name. Select Group. If you select Not mapping groups, users are only added to the default group, and it ignores any groups specified in the CSV/XLSX file.
Click Next after mapping the fields.
The results screen appears after checking for the existence of the group. If the group doesn't exist, it adds the user to the default group only and not to the group you specify. Click Add User to continue importing users.
If the selected group is not existing, add the user except for that group.
If you did not specify a group in the user list file, or if you selected Not mapping groups in Step 7 Fields Mapping, the Check for Group existence step is skipped.
User import in progress screen appears. The progress graph shows the progress of the user import. Please wait a few minutes for the process to be done.
You can only import one CSV or XLSX file at a time. If an import is in progress, wait until the import in progress is finished, then start a new import.
After you finish importing users, the Log Details screen appears. You can see the results of the import user in Status in the log table. User Import Results can be checked in the list or downloaded as a CSV or XLSX file.
What you can see in the table as follows:
Total: The total number of users targeted for user import.
Success: The number of users imported successfully.
Failed: The number of users that failed to import users.
Rows per page: The number of rows to display User Import Results.
(Download): Download User Import Results to a CSV or XLSX file.
No: Shows the serial number of the user list. Note that the list is always numbered, with the newest being #1.
Email: The imported user's email address.
Group Name: The group name to which users specified in the user list file will be added.
Status: The result of the user import. Status shows the success/failed results for importing users, not for moving groups.
Description: Shows the success/failed reasons for the group move. If you hover over the description message, the name of the group that failed to move is displayed as a tooltip. For example, in the image below, test-123 is the group name where the move failed.
If you don't specify a group in the user list file or specify a group does not exist, the group name is blank.
Click Complete to finish the User Import.
User import can only add one CSV or XLSX file at a time. If a user import is in progress, you can add a new user list file after that task is complete.
On This Page