Previewing Template Imports and Reviewing Import Results

Before you import a template, you can preview it to visualize the changes that the template import will create in the target environment. After you run the import, you can review the results for each object.

Previewing Template Imports

Previewing a template import enables you to identify the objects in the template file and to determine which ones will be added, modified, unchanged, and skipped by the import process. If there are issues with some of the objects in the template file, previewing the import enables you to identify those issues and take corrective action on them before the template is imported.

Use the preview status filters to identify potential issues with the template file before you import it:

  • Success: The object is projected to be imported from the import file without any changes.
  • Warning: The object is projected to be imported, but it will be changed from the import file in order to import it.
  • Error: The object is not projected to be imported.

Click Download download button to download the preview results to an Excel file. The file contains a Summary tab with information about the preview, such as the timestamp, file name, and the preview options, as well as an Import Preview tab that contains the preview information for the template import. The preview tab is sorted by preview result and then object type.

In the following example, the preview indicates that a permission for Barry Dylan will not be imported because the user doesn't exist in the target environment. You must add the user in the target environment in order to import the permissions for that users.


screenshot showing import preview as described above

Reviewing Import Results

After you run the template import, review the results to identify the status for each of the objects in the template file:

  • Success: The object was imported from the import file without any changes.
  • Warning: The object was imported, but it was changed from the import file in order to import it.
  • Error: The object was not imported.

You can enable and disable each of these filters to see just the objects that have a particular status. For example, you can view only the objects with warnings or errors.

Click Download download button to download the import results to an Excel file. The file contains a Summary tab with information about the import, such as the timestamp, file name, and the import options, as well as an Import Results tab that contains the results for the template import. The results tab is sorted by object type.

In the following example, the permission for Barry Dylan in the template was not imported because the user does not exist in the target environment.


template import results with status filters highlighted