Skip to end of metadata
Go to start of metadata

Importing a configuration file or a set of projects with their data into Jira may change many things in Jira configuration. It is also likely to change global objects (schemes, workflows, custom fields, etc.) that may be used by other projects. Given this potential impact on the target projects and other projects in Jira, it is important to understand your source instance. A smooth migration starts with setting up your export file. To ensure that your export file won't introduce any unwanted changes, we recommend that you follow the best practices below. You can also use the Project Configurator Checklist as a quick reminder of all the import prerequisites and tasks before proceeding with any migration process.


Understand Your Source Instance

Run the Object Dependencies report to give you a detailed view of where objects are used or referenced by other objects in your configuration.




Review Project Configurator's Export Options and Limitations

Read about the different export options available whether you are exporting complete projects or configuration only, and understand which objects are not supported by Project Configurator.

Limit Disruptions to Users

Perform your export process when it will have minimal impact on users. If you are exporting complete projects, consider excluding attachments from the export to reduce the file size and time required to compile the file. See Attachments Migration Mode for more information.

Back Up Your Source Instance

Before compiling an export file for your configuration or project data, it is good practice to always create a backup of your source instance. See Backing Up Jira Data for more information.


Follow a Defined Process

Promoting configuration changes, importing projects from another instance or merging instances of Jira may in some cases be complex tasks. Your chances of success will be much higher if you follow some best practices and avoid common pitfalls. We recommend reading the Migrating Data with Adaptavist page that we prepared in collaboration with Atlassian. It describes the recommended process for each process.


  • No labels