This documentation has moved. For the most recent documentation, check out Please update your bookmarks and links.

Skip to end of metadata
Go to start of metadata
Import Simulation is highly recommended before every import task! It provides an overview of the changes that will be applied to the target, giving you the flexibility to refine the content of your import.

The Import Simulation page is a preview of the changes that would be applied when the actual import is launched. You can launch a simulation by selecting the First Run a Simulated Configuration Import option on the Import Options page. When you click Import Project Configuration, the simulation is launched and the results are displayed in a tree format (Import Operations Tree) on the results page.

Import Simulation Results

When the simulation has loaded, the Import Operations Tree is displayed with all your configuration action options enabled.

Understand Your Results

The Import Operations Tree has four categories identified by colour:

  • Objects displayed in blue exist in the target and are modified during the actual import.
  • Objects displayed in green do not exist in the target. These are created during the actual import. Changes associated with newly created objects are also displayed in green.
  • Objects displayed in yellow are warnings that you might want to review before proceeding with the import. There are no actions associated with warnings.
  • Objects displayed in red are considered errors. These changes are not migrated. You can choose to resolve the errors before proceeding with an actual import.  If you do perform an import with errors, the objects are skipped but the import will still be completed.


Do not be alarmed if the simulation shows several errors. Often, a single error will trigger multiple associated errors. For example, a Software project type cannot be created because the number of users with access to Jira Software has exceeded the license. This will trigger errors for all changes in that project including creation of versions, components, assigning users to roles, assigning schemes, and creating filters, and dashboards related to that project.  Review groups of errors to identify the root cause and make any necessary changes you identify before running the simulation again.

Navigate the Import Operations Tree

  • You can expand and collapse a category by clicking the arrows at the left of the tree. 
  • The coloured icons at the left of each category show the number of actions, warnings, and errors.
  • You can disable or re-enable any actions by clicking the coloured icons next to the object titles. The example below shows the Modify action enabled for Version 1.0. Please note, errors are always skipped from the import whether or not the action is enabled.


Apply Configuration: Proceeds to the actual import after you have reviewed your simulation and made any desired changes. 

Back to Options: Returns to the Import Options page.

Recalculate: After disabling or re-enabling any configuration changes, click Recalculate to update the configuration settings with your changes before selecting Apply Configuration.

Expand All: Expands the operations tree to the detailed view.

Fold All: Collapses the operations tree to show only the action titles.

Download: Allows you to download the results in a text file.