Export Datasmith Content (.udatasmith) Workflow

See how to export content from your design application to Twinmotion using the Export Datasmith Content workflow.

Windows
MacOS
Linux

The Export Datasmith Content workflow is available for 3ds Max, Archicad, BricsCAD, form•Z, Navisworks, Revit, Rhino, SketchUp Pro, SOLIDWORKS, and Vectorworks. To use this workflow, the Datasmith Exporter plugin for your design application must be installed. For more information on design applications that support Datasmith and where to download the plugins, see Supported Design Applications for Datasmith.

The Export Datasmith Content workflow enables you to export 3D models and assets from your design application to a .udatasmith file and a folder containing your material assets. The .udatasmith file and the material assets can then be imported into Twinmotion.

Exporting Your 3D Model and Assets

To export your 3D model and assets, use your design application to create a .udatasmith file and a folder containing the material assets of the scene. This file and the material assets are then imported into Twinmotion.

Create the .udatasmith File and Material Assets Folder

  1. In your design application, open the scene that you want to export.

  2. In the Datasmith Exporter toolbar, click Export to Datasmith.

  3. In the file browser window that opens, select the location where you want to save the .udatasmith file and folder.

  4. Choose a file name and click Save. The .udatasmith file and a folder containing the assets of the scene are created.

Import the .udatasmith File and Material Assets into Twinmotion

  1. In Twinmotion, click Import.

    import-icon.png

    The Import window opens.

    geometry-tab.png

  2. In the Geometry tab, click Open.

  3. In the file browser window, locate and select the .udatasmith file and click Open.

  4. In the Import window, click Options, and select your Datasmith Direct Link importing options. For more information about the importing options, see Import Options below.

    udatasmith-workflow-options.png

  5. Click Import. The import process starts, and the scene and material assets from your design application open in Twinmotion.

Import Options

Option

Description

Collapse

Keep hierarchy

Select this option to retain the same geometry hierarchy that is used in your source file. In Twinmotion, all objects will be separate and have their own pivot point, so you can move and manipulate them independently. Selecting this option also allows you to view BIM information for each element in your scene.

This option is useful if you want to create phasings. All objects inside your scene will be separate, making it possible to hide and show them as needed.

Retaining hierarchy is also useful if your scene contains dummy objects that need to be replaced by Twinmotion objects, as you will need each object to be separate.

Note: Although keeping the hierarchy is sometimes necessary, selecting this option will increase the size of your scene in Twinmotion.

Collapse by material

This is the recommended option and is selected by default.

This option optimizes the model for real-time rendering, as it reduces the number of objects that are imported into Twinmotion — all objects that use the same material are collapsed into one single group. If a material is modified on any of the objects in the group, it will also be modified on all objects in the group.

Collapse all

Select this option to import objects or scenes as a whole. In Twinmotion, the entire object or scene will be grouped as one element and controlled by one pivot point only, making it easier to move, select, or delete, or to save in the User Library.

Enable substitution

Select this option if you want to enable material substitution. When importing or reimporting scenes, this option enables you to replace any material that is used in your source file with a Twinmotion material. The material substitutions are defined in a .csv file. This can be useful if your scene contains many objects and you want to simplify material changes by being able to apply the same material to many objects.

Note: This option can be used with any of the Collapse options.

Substitution table

The .csv file that defines the material substitutions that you want to make when importing or re importing a scene.

By default, the .csv file is located in C:\Users[user name]\Documents\Twinmotion[2022.1].

Updating the Scene in Twinmotion

  1. In your design application, open the scene that you want to update in Twinmotion.

  2. In the Datasmith Exporter toolbar, click Export to Datasmith.

  3. In the file browser window that opens, select the location where you want to save the .udatasmith file and folder.

    You can create a new file and folder or just overwrite the existing ones.

  4. Choose a file name and click Save.

  5. In Twinmotion, click Import. The import process starts, and the scene and material assets from your design application open in Twinmotion.

  6. If the .udatasmith file name and location has not changed:

    • In the Import dock, click the Refresh icon above the .udatasmith icon to update the model.

If the .udatasmith file name and/or location has changed, you need to re import the file:

a. In the Import dock, click the ellipsis above the .udatasmith icon.

b. Click File Settings. The Datasmith File Import window opens.

c. In Your file, locate and select the new .udatasmith file, then select the import options and click OK.

If you have made changes to materials or objects, or have deleted objects, you can reimport the original settings for these items only from your source file, instead of doing a full reimport. In the Import dock, point your cursor above the scene icon, and select Reset transform on selection, Reset materials on selection, or Reimport deleted objects.

Note that if the link between your source file and Twinmotion is broken, you need to re-establish the link before selecting one of the options.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Dismiss