Reimporting Datasmith Content

This page describes how to reimport Datasmith content into the Unreal Editor, and how to control what updates get synchronized to the Actors in your Levels.

For background information, including an overview of what reimporting does to the assets in your Project and the Actors in your Level, see About the Datasmith Reimport Workflow.

Setting the Source File Location

By default, when you reimport a Datasmith Scene Asset, it will look for the source file at the same location it was in the last time you imported that scene. If you change your scene in your source application and re-save or re-export it to the same location on your computer, the reimport process should automatically pick it up.

However, in some cases, you might want to keep your updated scene file separate from your original scene file. Or, you might need to reimport the scene on a different computer from the one that you last used to import the scene, and you might not have access to that original path. In these cases, you can change the path to the source file that you want to use when you reimport the Datasmith Scene Asset.

To do this:

  1. Double-click the Datasmith Scene Asset in the Content Browser to open it in the Asset Editor.
  2. If the Details panel is hidden, show it by selecting Window > Details from the main menu.
  3. Expand the sections to find the File Path > Source File setting:
    Datasmith Scene source file
  4. Click the  icon, and browse to the new location of your source scene file on your computer.
  5. Save the Asset.

The next time you reimport the Datasmith Scene Asset, it will use the new file location you set above.

Reimporting the Datasmith Scene Asset

To reimport the Datasmith Scene Asset from a new version of a source file:

  1. Right-click the Datasmith Scene Asset in the Content Browser, and select Reimport from the contextual menu.
    Reimport the Datasmith Scene Asset
  2. You'll be prompted to specify some reimport options. These are the same ones you originally set on import, with a couple of additions.
    The new options, under Sync Current Level Actors, determine whether the updates made to your Datasmith Scene Asset should also be applied to any Datasmith Scene Actors in the current Level that were created from the Asset you're updating.
    Reimport options
    If you don't want to synchronize your Actors now, you can do it later. See Synchronizing a Datasmith Scene Actor with its Asset below.
    For more information on the other import options, see Datasmith Import Options.
  3. Set the options you want the importer to use, and click Import
The reimport process may overwrite Static Mesh geometry, Parent Materials, and Texture Assets in your Content Browser. For details, see About the Datasmith Reimport Workflow

Synchronizing a Datasmith Scene Actor with its Asset

There are two ways you can re-synchronize a Datasmith Scene Actor in a Level with its corresponding Datasmith Scene Asset:

During the Reimport

At the time you reimport a Datasmith Scene Asset:

  1. Open the Level that contains your Datasmith Scene Actor.
  2. Reimport your Datasmith Scene Asset as described under Reimporting the Datasmith Scene Asset above.
  3. In the Import Options dialog, find the Sync Current Level Actors section. Make sure to check the Datasmith Scene Actors box.
    If you want to add back to your Level any Actors that you've previously deleted, also check the Re-Spawn Deleted Actors option.
    Sync Level Actors
  4. Click Import.

After the Reimport

At any time after you reimport a Datasmith Scene Asset:

  1. Open the Level that contains your Datasmith Scene Actor.
  2. Select the Datasmith Scene Actor in the World Outliner.
    Select Datasmith Scene Actor
  3. In the Details panel, find the Datasmith section.
    Update Actors from Scene
  4. If you want to add back to your Level any Actors that you've previously deleted, check the Respawn deleted actors option.
  5. Click Update actors from Scene.

Reimporting Individual Assets

Instead of reimporting an entire Datasmith Scene Asset, you can pick and choose individual Static Mesh, Material, and Texture Assets to update.

To re-import a single Asset:

  1. Right-click the Asset in the Content Browser, and choose Reimport from the contextual menu.
    Reimport Static Mesh Asset
    For a Material Asset, choose Datasmith > Reimport Material.
    Reimport Material Asset
    You'll only see the Datasmith > Reimport Material option for Material Assets that Datasmith created from scratch to match a material definition in your source file, which is typically the case only for Parent Materials imported from 3ds Max. However, this option does not appear for Material Assets that are instances of Materials built in to Datasmith, which is typically the case for Materials imported from CAD files or SketchUp.
  2. You'll be prompted to specify some reimport options for the Asset.
    These are the same ones you originally set on import. For more information on all these options, see Datasmith Import Options.
When you re-import individual Assets, you don't get the option to synchronize Level Actors. Every reference to the Asset in your Project will automatically use the updated version of your Asset. See About the Datasmith Reimport Workflow.