Warnings before importing

Safety measures when importing

Importing a configuration file or a set of projects with their data into JIRA may change many things in JIRA configuration. It is likely to change also 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 highly recommended to follow this safety measures.

Before loading a project configuration into a production database:

  • Make a full backup of the database. If importing complete projects, consider backing up the attachments too (as the import will add attachments for the new projects being imported).
  • Launch previously a simulated load (see instructions here). Check the simulated load trace to verify that it actually does what you expect it to do.


The use of this plugin is restricted to system administrators in JIRA.


After importing configurations, it is highly recommended to reindex your database ! This is not needed if importing complete projects, as the data import stage will automatically launch a reindex.

Instance locked while project data is being imported (new at version 2.0)

If you load a complete project, i.e. not only its configuration but also issue data and attachments, while data is being imported your instance will be locked for a period of time. This period will last depending on the size of imported data. So, it makes sense to import projects out of office hours or, at least, warn users in advance that the system will not be available for some time.

Email notifications

When the plugin creates new users that have an email address, it will request JIRA to send them a notification email. Take into account that these notifications will be requested when the users are created, even if later the import fails and everything is rolled back. If you do not want these emails sent at the moment of user creation, consider disabling the email queue before the import. You can do it by navigating to the "Outgoing Mail" link at the system configuration page. You will get to a page with a "Disable Outgoing Mail" button at the top right corner.