How to change user information in Cloud to Server migration

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

The content on this page relates to platforms that are not supported by JIRA applications. Consequently, Atlassian can not guarantee providing any support for it. Please be aware that this material is provided for your information only and using it is done at your own risk.

Solution

Problem

When migrating Jira projects from cloud to on-premise, usernames, user Full Names, or e-mails can be modified to match the company's user guidelines.

For example, cloud usernames are set in unique long strings, and Full Name and email are retrieved as mail providers, as the image below:

(Auto-migrated image: description temporarily unavailable)

Depending on the company user guideline, the data can be modified to match, as example, a LDAP naming convention.

Steps for the change

Similarly to how to migrate user contributions to a new username the Jira Administrator shall edit the xml files from Cloud backup. With the steps:

  • Create a Cloud backup as seen here

    (Auto-migrated image: description temporarily unavailable)
  • Find the usernames to be modified in the entities.xml file present in the backup zip.

    (Auto-migrated image: description temporarily unavailable)

    (Auto-migrated image: description temporarily unavailable)
  • After mapping the username from entities.xml to the name to be used, use text substitution tools to modify both entities.xml and activeobjects.xml into new files, to be zipped.

    (note from this procedure you can also modify e-mail, names, etc)

    Example using unix sed to modify user string 606b70aea23f99007526df25 to dalves:

    1 2 3 4 5 6 mkdir jira-export; sed 's/606b70aea23f99007526df25/dalves/g' activeobjects.xml \ > jira-export/activeobjects.xml; sed 's/606b70aea23f99007526df25/dalves/g' entities.xml \ > jira-export/entities.xml; zip jira-export.zip jira-export
  • Transfer the new zip files, with modified data, to Jira import folder (jira-home/import) and proceed with the data restore.

    (Auto-migrated image: description temporarily unavailable)

Updated on April 15, 2025

Still need help?

The Atlassian Community is here for you.