How to update usernames in bulk using Jira Command Line Interface

This article explains how to update the username of a user in bulk using the app, Jira Command Line Interface.


  1. Use the action updateUser with runFromCsv to add users to a group in bulk.
  2. Prepare a CSV file (updateuser.csv) that contains userId and newUserId columns. Enter the userId of the users that are to be modified under the userId column. Under the newUserId column enter the new user IDs that are to be added.
    An example file is shown below: 

  3. Run the command given below to update the usernames of the users that are provided in the .csv file (updateuser.csv in this example).

    --action runFromCsv --file updateuser.csv --common "-a updateUser"  

The parameters used in the above action are:

  • fileName (or path) of the file specified in the command.
  • common: Common parameter string added to all run actions.

It is recommended to test the command in a non-production environment or run the action with the --simulate parameter to verify the behavior before deploying.