---
title: "Import simulation"
canonical: "https://support.appfire.com/space/PC/197887740/Import%20simulation"
format: markdown
---
> Macro (aura-html)

> ✅ If you are using a Project Configurator version earlier than 3.0.0, you should use the [import conflict detection report](https://appfire.atlassian.net/wiki/spaces/PC/pages/197952280).

<span style="color: #172b4d">Import Simulation is highly recommended before every import task! It provides a preview of the configuration changes that will be applied to your target instance, including new objects that will be created and existing objects that will be modified. It also displays warnings and errors generated from the import file. You can then make changes directly in the import results page or to your target instance before proceeding with the actual import.</span>

## Run an import simulation

<span style="color: #172b4d">You run a simulation by first selecting the </span>**Run a Simulated Import**<span style="color: #172b4d"> option on the </span>*Import Projects*<span style="color: #172b4d"> screen. When you click </span>**Import Projects**<span style="color: #172b4d">, the simulation is launched, and the results are displayed in a tree format (import operations tree) on the results page.</span>

![image](media://4eec4e97-eb83-4a17-9289-2b35ddee1532)

## Import simulation results

When the simulation is complete, the import operations tree displays with all your configuration action options enabled. Always review the configuration changes that will be applied to your target instance before clicking **Apply Configuration**.

![An example Import Operations Tree.](media://ff654972-efd1-4ecb-ad4a-8ab0773e845c)

### Understand your results

The import operations tree identifies the simulated actions by color to help you quickly identify configuration changes, additions, warnings, and errors.

> ✅ **Simulation Errors**
> ✅ 
> ✅ Do not be alarmed if the simulation shows several errors. Often, a single error will trigger multiple associated errors. Review groups of errors to identify the root cause and make any necessary changes you identify before running the simulation again.

---

## Review and modify configuration changes

### Review

Changes are grouped by object category with the number of changes indicated on the category action label. Click the arrows at the left of the object label to expand or collapse a group of related changes. To expand all the object groups at once, click **Expand All**.

![image](media://358fa5ed-2148-4c5a-a27b-bb837a1c5856)

### Modify

If you want to make changes to the import before proceeding, you can disable individual changes or groups of changes. Disabled changes are excluded from the actual import. 

To disable a single change, click the colored change description. To disable a group of changes, click the colored action label. Disabled items are displayed in gray. Click the item again to re-enable it. Remember that only additions (green) and modifications (blue) can be disabled. Warnings and errors are not import items.

In the following example, a filter category action was disabled, including all its associated actions.

![image](media://5c581e36-8996-431a-aa31-f36ea238f4c2)

<span style="color: #172b4d">If your simulation identifies errors, you may need to make changes to your target instance (open an additional browser tab) before proceeding with the actual import. Always click </span>**Recalculate**<span style="color: #172b4d"> after making modifications to your import simulation results to ensure that your changes do not introduce any unexpected changes.</span>

## Navigation

- **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**: Updates the configuration settings before proceeding with the actual import. Typically used after making any changes to the simulated results or to your target instance.
- **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.